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这 篇 文章 的 英文 原版 我 是 在 www.FreeRTOS.net 上 下 载 得 到 的 。 其实 我 并 没有 决定 
是 否 要 在 系统 中 使 用 FreeRTOS， 虽 然 我 想 要 的 也 仅仅 是 一 个 实时 内 核 ， 当 然 更 重要 的 
是 免费 。 之 所 以 翻译 这 篇 文章 倒 不 是 因为 FreeRTOS 有 多 么 优秀 ， 完 全 是 因为 这 篇 文章 
还 不 算 太 长 。 而 且 FreeRTOS.net 仿 佛 致力 于 这 个 内 核 在 国内 的 推广 ， 也 做 了 不 少 中 文 
化 的 工作 。 所 以 我 是 打算 利用 工作 之 余 ， 边 看 边 译 ， 到 读 完 这 篇 文档 ， 也 就 有 个 中 文 版 
了 。 如 果 FreeRTOS.net 不 弃 的 话 ， 我 倒是 情愿 放 到 这 个 网 站 上 与 大 家 共享 。 















































另外 ， 我 本 人 很 懒 ， 没 有 翻译 附录 ， 而 且 译 完 正 文 后 也 没有 做 过 任何 检查 。 所 以 如 
果 有 任何 问题 ， 请 不 要 加 我 。 











Zou Changjun 
yisfx@ 126.com 
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1.1 概览 

















[附录 中 提供 了 使 用 FreeRTOS 源 代 码 的 实用 信息 ] 





小 型 多 任务 戏 入 式 系统 简介 
不 同 的 多 任务 系统 有 不 同 的 侧重 点 。 以 工作 站 和 桌面 电脑 为 例 : 




















。 早期 的 处 理 器 非常 昂贵 ， 所 以 那 时 的 多 任务 用 于 实现 在 单 处 理 器 上 支持 多 用 户 。 这 
类 系统 中 的 调度 算法 侧重 于 让 每 个 用 户 " 公 平 共享 ”处理 器 时 间 。 



































。 随 着 处 理 器 功能 越 来 越 强 大 ， 价 格 却 更 偏 宜 ， 所 以 每 个 用 户 都 可 以 独占 一 个 或 多 个 
处 理 器 。 这 类 系统 的 调度 算法 则 设计 为 让 用 户 可 以 同时 运行 多 个 应 用 程序 ， 而 计算 
机 也 不 会 显得 反应 述 印 。 例 如 某 个 用 户 可 能 同时 运行 了 一 个 字 处 理 程序 ， 一 个 电子 












































表格 ， 一 个 邮件 客户 端 和 一 个 WEB 浏览 器 ， 并 且 期 望 每 个 应 用 程序 任何 时 候 都 能 
对 输入 有 足够 快 的 啊 应 时 间 。 








桌面 电脑 的 输入 处 理 可 以 归 类 为 " 软 实时 ”。 为 了 保证 用 户 的 最 佳 体验 ， 计 算 机 对 每 
个 输入 的 啊 应 应 当 限 定 在 一 个 恰当 的 时 间 范 围 一 一 但 是 如 果 啊 应 时 间 超 出 了 限定 范围 ， 
并 不 会 让 人 觉得 这 人 台电 脑 无 法 使 用 。 比 如 说 ， 键 盘 操 作 必 须 在 键 按 下 后 的 某 个 时 间 内 作 
出 明显 的 提示 。 但 如 果 按 键 提示 超出 了 这 个 时 间 ， 会 使 得 这 个 系统 看 起 来 响应 太 慢 ， 而 




















不 致 于 说 这 全 电脑 不 能 使 用 。 


DUDUM HA 
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器 运行 多 线程 这 一 点 来 说 , 实时 嵌入 式 系统 中 的 多 任务 与 桌面 电脑 的 


特别 




















是 当 幅 入 式 系 统 期 望 提供 " 硬 实时 "行为 的 时 候 。 
便 实 时 功能 必须 在 给 定 的 时 间 限 制 之 内 完成 一 一 如 果 无 法 做 到 即 意味 着 整个 系统 
的 绝对 失败 。 汽车 的 安全 气 吉 触发 机 制 就 是 一 个 便 实时 功能 的 例子 。 安 全 气 宫 在 接 击 发 


生 后 给 定时 间 限 人 




















上 内 必须 弹出 。 如 果 响 应 时 间 超 出 了 这 个 时 间 限 制 ,会 使 得 驾驶 员 受 到 





伤害 ， 而 这 原本 是 可 以 避免 的 。 
大 多 数 租 入 式 系 统 不 仅 能 满足 硬 实时 要 求 ， 也 能 满足 软 实时 要 求 。 
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术语 说 明 


在 FreeRTOS 中 ， 每 个 执行 线程 都 被 称 为 "任务 "。 在 嵌入 式 社区 中 ， 对 此 并 没有 一 


个 公允 的 术语 ， 但 我 更 喜欢 用 "任务 ”而 不 是 线程”， 因 为 从 以 前 的 经 验 来 看 ， 线 程 具 有 


更 多 的 特定 含义 。 





本 章 的 目的 是 让 读者 充分 了 解 : 




















。 在 应 用 程序 中 ，FreeRTOS 如 何 为 各 任务 分 配 处 理 时 间 。 








。 在 任意 给 定时 刻 ，FreeRTOS 如 何 选 择 任务 投入 运行 。 
© 任务 优先 级 如 何 影响 系统 行为 。 
。 任务 存在 哪些 状态 。 





此 外 ， 还 期 望 能 够 让 读者 解 : 
。 如 何 实现 一 个 任务 。 
。 如 何 创建 一 个 或 多 个 任务 的 实例 。 
。 如何 使 用 任务 参数 。 
。 如何 改变 一 个 已 创建 任务 的 优先 级 。 
。 如 何 删除 任务 。 
。 如何 实现 周期 性 处 理 。 
。 空闲 任 务 何 时 运行 ， 可 以 用 来 干什么 。 






































本 章 所 介绍 的 概念 是 理解 如 何 使 用 FreeRTOS 的 基础 ， 也 是 到 








E 解 基于 FreeRTOS 

















的 应 用 程序 行为 方式 的 基础 一 一 因此 ， 本 章 也 是 这 本 书 中 最 为 详尽 的 一 章 。 
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1.2 任务 函数 


任务 是 由 C 语言 函数 实现 的 。 唯 一 特别 的 只 是 任务 的 函数 原型 ， 其 必须 返回 void, 
而 且 带 有 一 个 void 指针 参数 。 其 函数 原型 参见 程序 清单 1。 


void ATaskFunction( void *pvParameters ) ; 


程序 清单 1 任务 函数 原型 











每 个 任务 都 是 在 自己 权限 范围 内 的 一 个 小 程序 。 其 具有 程序 入 口 , 通常 会 运行 在 一 
个 死 循环 中 ， 也 不 会 退出 。 一 个 典型 的 任务 结构 如 程序 清单 2 所 示 。 

FreeRTOS 任务 不 允许 以 任何 方式 从 实现 函数 中 返回 一 一 它们 绝 不 能 有 一 
条 "return 语句 ， 也 不 能 执行 到 函数 末尾 。 如 果 一 个 任务 不 再 需要 ， 可 以 显 式 地 将 其 删 
除 。 这 也 在 程序 清单 2 展现 。 

一 个 任务 函数 可 以 用 来 创建 若干 个 任务 一 一 创建 出 的 任务 均 是 独立 的 执行 实例 , 拥 
有 属于 自己 的 栈 空间 , 以 及 属于 自己 的 自动 变量 ( 栈 变量 ), 即 任务 函数 本 身 定 义 的 变量 。 



























































void ATaskFunction( void *pvParameters ) 

{ 

/* 可 以 像 普 通 函 数 一 样 定义 变量 。 用 这 个 函数 创建 的 每 个 任务 实例 都 有 一 个 属于 自己 的 ijVarialbleExample 变 
量 。 但 如 果 iVariableExample 被 定义 为 static， 这 一 点 则 不 成 立 - 这 种 情况 下 只 存在 一 个 变量 ， 所 有 的 任务 实 
例 将 会 共享 这 个 变量 。 */ 


int iVariableExample = 0; 


























/* 任务 通常 实现 在 一 个 死 循 环 中 。 */ 
for( ;; ) 
{ 
/* 完成 任务 功能 的 代码 将 放 在 这 里 。 / 











/* 如 果 任 务 的 具体 实现 会 跳出 上 面 的 死 循 环 ， 则 此 任务 必须 在 函数 运行 完 之 前 删除 。 传 入 NULL 参 数 表示 删除 
的 是 当前 任务 */ 
vTaskDelete( NULL ); 


程序 清单 2 典型 的 任务 函数 结构 


FreeRTOS 6 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http://www.FreeRTOS.org 


顶层 任务 状态 








应 用 程序 可 以 包含 多 个 任务 。 如 果 运 行 应 用 程序 的 微 控制 器 只 有 一 个 核 (core)， 那 
么 在 任意 给 定时 间 , 实际 上 只 会 有 一 个 任务 被 执行 。 这 就 意味 着 一 个 任务 可 以 有 一 个 或 
两 个 状态 ， 即 运行 状态 和 非 运 行 状 态 。 我 们 先 考 虑 这 种 最 简单 的 模型 一 一 但 请 牢记 这 其 

过 于 简单 ， 我 们 稍 后 将 会 看 到 非 运行 状态 实际 上 又 可 划分 为 若干 个 子 状态 。 

当 某 个 任务 处 于 运行 态 时 ， 处 理 器 就 正在 执行 它 的 代码 。 当 一 个 任务 处 于 非 运行 态 
时 ， 该 任务 进行 休眠 ， 它 的 所 有 状态 都 被 妥善 保存 ， 以 便 在 下 一 次 调试 器 决定 让 它 进 入 
运行 态 时 可 以 恢复 执行 。 当 任务 恢复 执行 时 ， 其 将 精确 地 从 离开 运行 态 时 正 准 备 执行 的 
那 一 条 指令 开始 执行 



































All tasks that are Only one task 
not currently can be In the 
Running are in the Running state at 
Not Running State any one time 





图 1 顶层 任务 状态 及 状态 转移 


任务 从 非 运 行 态 转移 到 运行 态 被 称 为 ?切换 入 或 切入 (switched in)" 或 "交换 入 
(swapped in)”。 相 反 ， 任 务 从 运行 态 转移 到 非 运行 态 被 称 为 "切换 出 或 切 出 (switched 
out)”* 或 "交换 出 (swapped out)". FreeRTOS 的 调度 器 是 能 让 任务 切入 切 出 的 唯一 实体 。 
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1.4 创建 任务 


xTaskCreate() API 函数 
创建 任务 使 用 FreeRTOS 的 API 函数 xTaskCreate(). 这 可 能 是 所 有 API 函数 中 最 
复杂 的 函数 , 但 不 幸 的 是 这 也 是 我 们 第 一 个 遇 到 的 APT 函数 .但 我 们 必须 首先 掌控 任务 ， 
因为 它们 是 多 任务 系统 中 最 基本 的 组 件 。 本 书 中 的 所 有 示例 程序 都 会 用 到 
xTaskCreate()， 所 以 会 有 大 量 的 例子 可 以 参考 。 





















































附录 5: 描述 用 到 的 数据 类 型 和 命名 约定 。 














portBASE TYPE xTaskCreate( pdTASK_ CODE pvTaskCode, 
const signed portCHAR * const pcName, 
unsigned portSHORT usStackDepth, 
void *pvParameters, 
unsigned portBASE TYPE uxPriority, 
xTaskHandle *pxCreatedTask ); 


程序 清单 3 xTaskCreate() API 函数 原型 


表 1 xTaskCreate() 参 数 与 返回 值 



































参数 名 描述 
pvTaskCode 任务 只 是 永 不 退出 的 C 函数 ， 实 现 常 通常 是 一 个 死 循环 。 参数 
pvTaskCode 只 一 个 指向 任务 的 实现 函数 的 指针 (效果 上 仅仅 是 函数 
名 )。 
pcName 具有 描述 性 的 任务 名 。 这 个 参数 不 会 被 FreeRTOS 使 用 。 其 只 是 单 
纯 地 用 于 辅助 调试 。 识 别 一 个 具有 可 读 性 的 名 字 总 是 比 通过 句柄 来 
识别 容易 得 多 。 





应 用 程序 可 以 通过 定义 常量 config_MAX_TASK_NAME LEN 来 定 
义 任务 名 的 最 大 长 度 一 一 包括 \0’ 结 束 符 。 如 果 传 入 的 字符 串 长 度 超 
过 了 这 个 最 大 值 ， 字 符 串 将 会 自动 被 截断 。 
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usStackDepth 


pvParameters 


uxPriority 


FreeRTOS 














当 任务 创建 时 , 内 核 会 分 为 每 个 任务 分 配属 于 任务 自己 的 唯一 状态 。 
usStackDepth 值 用 于 告诉 内 核 为 它 分 配 多 大 的 栈 空间 。 























这 个 值 指定 的 是 栈 空间 可 以 保存 多 少 个 字 (word)， 而 不 是 多 少 个 字 
节 (byte)。 比 如 说 ， 如 果 是 32 位 宽 的 栈 空间 , 传 入 的 usStackDepth 
值 为 100， 则 将 会 分 配 400 字 节 的 栈 空间 (100 * 4bytes)。 栈 深度 乘 
以 栈 宽度 的 结果 干 万 不 能 超过 一 个 size t 类 型 变量 所 能 表达 的 最 大 
值 。 






































应 用 程序 通过 定义 常量 configMINIMAL STACK SIZE 来 决定 空闲 
任务 任用 的 栈 空间 大 小 。 在 FreeRTOS 为 微 控 制 器 架构 提供 的 
Demo 应 用 程序 中 ， 赋 予 此 第 量 的 值 是 对 所 有 任务 的 最 小 建议 值 。 
如 果 你 的 任务 会 使 用 大 量 栈 空 间 ， 那 么 你 应 当 赋予 一 个 更 大 的 值 。 




































































没有 任何 简单 的 方法 可 以 决定 一 个 任务 到 底 需 要 多 大 的 栈 空 间 。 计 
算出 来 虽然 是 可 能 的 ， 但 大 多 数 用 户 会 先 简单 地 赋予 一 个 自 认 为 合 
理 的 值 , 然后 利用 FreeRTOS 提供 的 特性 来 确证 分 配 的 空间 既 不 从 
缺 也 不 浪费 。 第 六 章 包 括 了 一 些 信息 ， 可 以 知道 如 何 去 俘 询 任务 使 
用 了 多 少 栈 空间 。 






























































任务 函数 接受 一 个 指向 void 的 指针 (void*)。pvParameters 的 值 即 
是 传递 到 任务 中 的 值 。 这 篇 文档 中 的 一 些 范例 程序 将 会 示范 这 个 参 
数 可 以 如 何 使 用 。 








指定 任务 执行 的 优先 级 。 优 先 级 的 取 值 范围 可 以 从 最 低 优先 级 0 到 
最 高 优先 级 (configMAX_PRIORITIES - 1). 














configMAX_PRIORITIES 是 一 个 由 用 户 定义 的 常量 。 优 先 级 号 并 没 
有 上 限 (除了 受 限 于 采用 的 数据 类 型 和 系统 的 有 效 内 存 空 间 )， 但 最 
好 使 用 实际 需要 的 最 小 数值 以 避免 内 存 浪费 。 如 果 uxPriority 的 值 
超过 了 (configMAX_PRIORITIES — 1), 将 会 导致 实际 赋 给 任务 的 优 
先 级 被 自动 封顶 到 最 大 合法 值 。 
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pxCreatedTask ^ pxCreatedTask 用 于 传 出 任务 的 句柄 。 这 个 句柄 将 在 API 调用 中 对 
该 创建 出 来 的 任务 进行 引用 ， 比 如 改变 任务 优先 级 , 或 者 删除 任务 。 





如 果 应 用 程序 中 不 会 用 到 这 个 任务 的 句柄 ， 则 pxCreatedTask 可 以 
被 设 为 NULL。 


返回 值 有 两 个 可 能 的 返回 值 : 











1. pdTRUE 





表明 任务 创建 成 功 。 


2. erCOULD NOT ALLOCATE REQUIRED MEMORY 




















由 于 内 存 堆 空间 不 足 ，FreeRTOS 无 法 分 配 足够 的 空间 来 保存 任务 
结构 数据 和 任务 栈 ， 因 此 无 法 创建 任务 。 








Ne 












































第 五 章 将 提供 更 多 有 关内 存 管 理 方面 的 信息 。 





例 1. 创建 任务 
附录 d: 包含 一 些 关 于 示例 程序 生成 工具 的 信息 。 

















本 例 演示 了 创建 并 启动 两 个 任务 的 必要 步骤 。 这 两 个 任务 只 是 周期 性 地 打印 输出 字 
TERR. 采用 原始 的 空 循环 方式 来 产生 周期 延迟 。 两 者 在 创建 时 指定 了 相同 的 优先 级 ， 并 
且 在 实现 上 除 输出 的 字符 串 外 完全 一 样 一 一 程序 清单 4 和 程序 清单 5 是 这 两 个 任务 对 应 
的 实现 代码 。 
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void vTaskl( void *pvParameters ) 


( 


const char *pcTaskName = "Task 1 is running\r\n"; 


volatile unsigned long ul; 


/* 和 大 多 数 任务 一 样 ， 该 任务 处 于 一 个 死 循 环 中 。 */ 
for( ;; ) 


( 





/* Print out the name of this task. */ 


vPrintString( pcTaskName ); 














/* 延迟 ， 以 产生 一 个 周期 */ 
for( ul = 0; ul < mainDELAY LOOP COUNT; ul++ ) 














{ 
/* 这 个 空 循环 是 最 原始 的 延迟 实现 方式 。 在 循环 中 不 做 任何 事情 。 后 面 的 示例 程序 将 采用 
delay/sleep 消 数 代 蔡 这 个 原始 空 循环 。 */ 

} 


程序 清单 4 例 1 中 的 第 一 个 任务 实现 代码 


void vTask2( void *pvParameters ) 


{ 


const char *pcTaskName = "Task 2 is running\r\n"; 


volatile unsigned long ul; 





/* 和 大 多 数 任务 一 样 ， 该 任务 处 于 一 个 死 循 环 中 。 */ 
for( ;; ) 
{ 

/* Print out the name of this task. */ 


vPrintString( pcTaskName ); 














/* 延迟 ， 以 产生 一 个 周期 */ 
for( ul = 0; ul < mainDELAY LOOP COUNT; ul++ ) 








{ 
/* 这 个 空 循环 是 最 原始 的 延迟 实现 方式 。 在 循环 中 不 做 任何 事情 。 后 面 的 示例 程序 将 采用 
delay/sleep 函 数 代 符 这 个 原始 空 循环 。 */ 

} 


程序 清单 5 例 1 中 的 第 二 个 任务 实现 代码 
main() 函 数 只 是 简单 地 创建 这 两 个 任务 , 然后 局 动 调度 器 一 一 具体 实现 代码 参见 程 
序 程 单 6。 
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int main( void ) 










































































{ 
/* 创建 第 一 个 任务 。 需 要 说 明 的 是 一 个 实用 的 应 用 程序 中 应 当 检测 函数 xTaskcreate () 的 返回 值 ， 以 确保 任 
务 创建 成 功 。 */ 
xTaskCreate( vTask1, /* 指向 任务 函数 的 指针 */ 
"Task 1", /* 任务 的 文本 名 字 ， 只 会 在 调试 中 用 到 */ 
1000, /* 栈 深度 - 大 多 数 小 型 微 控制 器 会 使 用 的 值 会 比 此 值 小 得 多 */ 
NULL, /* 没有 任务 参数 */ 
1, /* 此 任务 运行 在 优先 级 1 上 . */ 
NULL ); /* 不 会 用 到 任务 句柄 */ 
/* Create the other task in exactly the same way and at the same priority. */ 
xTaskCreate( vTask2, "Task 2", 1000, NULL, 1, NULL ); 
/* 启动 调度 器 ， 任 务 开始 执行 */ 
vTaskStartScheduler () ; 
/* 如 果 一 切 正 常 ，main () 函数 不 应 该 会 执行 到 这 里 。 但 如 果 执 行 到 这 里 ， 很 可 能 是 内 存 堆 空间 不 足 导致 空闲 
任务 无 法 创建 。 第 五 昔 有 讲述 更 多 关于 内 存 管 理 方面 的 信息 */ 
for( ;; ); 
} 


程序 清单 6 启动 例 1 中 的 任务 


本 例 的 运行 输出 如 图 2 所 示 


C: NTenp?rtos demo 

is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
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图 2 Bil 1 的 运行 输出 




















图 2 中 看 到 两 个 任务 在 同时 运行 , 但 实际 上 这 两 个 任务 运行 在 同一 个 处 理 器 上 , 所 
以 不 可 能 会 同时 运行 。 事 实 上 这 两 个 任务 都 迅速 地 进入 与 退出 运行 态 。 由 于 这 两 个 任务 
运行 在 同一 个 处 理 器 上 ， 所 以 会 平等 共享 处 理 器 时 间 。 真 实 的 执行 流程 所 图 3 所 示 。 
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图 3 中 底部 的 箭头 表示 从 tf 起 始 的 运行 时 刻 。 彩 色 的 线段 表示 在 每 个 时 间 点 上 正 
在 运行 的 任务 一 一 比如 t1 与 世 之 间 运 行 的 是 任务 1. 

在 任何 时 刻 只 可 能 有 一 个 任务 处 于 运行 态 。 所 以 一 个 任务 进入 运行 态 后 (切入 )， 74 
一 个 任务 就 会 进入 非 运 行 态 ( 切 出 )。 

















Attime t1, Task 1 At time t2 Task 2 enters the Running |^. 
enters the Running state and executes until time t3 - at 

state and executes which point Task1 re-enters the 

until time t2 Running state 











Task 2 / 一 — — 


Y T 3 Time 





图 3 例 1 的 实际 执行 流程 


fil 1 中 ，main() 冰 数 在 启动 调度 器 之 前 先 完成 两 个 任务 的 创建 。 当 然 也 可 以 从 一 个 
任务 中 创建 男 一 个 任务 。 我 们 可 以 先 在 main() 中 创建 任务 1, 然后 在 任务 1 中 创建 任务 
2。 如 果 我 们 需要 这 样 做 ， 则 任务 1 代码 就 应 当 修 改 成 程序 清单 7 所 示 的 样子 。 这 样 ， 
在 调度 器 启动 之 前 ， 任 务 2 还 没有 被 创建 ， 但 是 整个 程序 运行 的 输出 结果 还 是 相同 的 。 
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void vTaskl( void *pvParameters ) 


( 


const char *pcTaskName = "Task 1 is running\r\n"; 


volatile unsigned long ul; 








/* 如果 已 经 执行 到 本 任务 的 代码 ， 表 明 调 度 器 已 经 启动 。 在 进入 死 循环 之 前 创建 另 一 个 任务 。 */ 
xTaskCreate( vTask2, "Task 2", 1000, NULL, 1, NULL ) 


for( ?7 ) 
{ 
/* Print out the name of this task. */ 


vPrintString( pcTaskName ) ; 


/* Delay for a period. */ 
for( ul = 0; ul < mainDELAY LOOP COUNT; ul++ ) 


{ 
/* This loop is just a very crude delay implementation. There is 
nothing to do in here. Later examples will replace this crude 
loop with a proper delay/sleep function. */ 

} 


程序 清单 7 在 一 个 任务 中 创建 男 一 个 任务 一 一 在 调度 器 启动 之 后 


例 2. 使 用 任务 参数 

例 1 中 创建 的 两 个 任务 几乎 完全 相同 , 唯一 的 区 别 就 是 打印 输出 的 字符 串 。 这 种 重 
复 性 可 以 通过 创建 同一 个 任务 代码 的 两 个 实例 来 去 除 。 这 时 任务 参数 就 可 以 用 来 传递 各 
自打 印 输出 的 字符 串 。 

程序 清单 8 包含 了 例 2 中 用 到 的 唯一 一 个 任务 函数 代码 (vTaskFunction)。 这 一 个 
任务 函数 代替 了 例 1 中 的 两 个 任务 函数 (vTask1 与 vTask2)。 这 个 函数 的 任务 参数 被 强 
制 转化 为 char* 以 得 到 任务 需要 打印 输出 的 字符 串 。 
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void vTaskFunction( void *pvParameters ) 


{ 


char *pcTaskName; 


volatile unsigned long ul; 








/* 需要 打印 输出 的 字符 串 从 入 口 参数 传 入 。 强 制 转换 为 字符 指针 。 */ 


pcTaskName = ( char * ) pvParameters; 














/* As per most tasks, this task is implemented in an infinite loop. */ 
for( ;; ) 
/* Print out the name of this task. */ 


vPrintString( pcTaskName ); 


/* Delay for a period. */ 


for( ul = 0; ul « mainDELAY LOOP COUNT; ul++ ) 


{ 
/* This loop is just a very crude delay implementation. There is 
nothing to do in here. Later exercises will replace this crude 
loop with a proper delay/sleep function. */ 

i 


程序 清单 8 例 2 中 用 于 创建 两 个 任务 实例 的 任务 函数 











尽管 现在 只 有 一 个 任务 实现 代码 (vTaskFunction), 但 是 可 以 创建 多 个 任务 实例 。 
个 任务 实例 都 可 以 在 FreeRTOS 调度 器 的 控制 下 独 运 行 。 

传递 给 API 函数 xTaskCreate() 的 参数 pvPrameters 用 于 传 入 字符 串 文 本 。 如 程序 
清单 9 所 示 。 
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/* 定义 将 要 通过 任务 参数 传递 的 字符 串 。 定 义 为 const， 且 不 是 在 栈 空 间 上 ， 以 保证 任务 执行 时 也 有 效 。 */ 





static const char *pcTextForTaskl = “Task 1 is running\r\n’; 


static const char *pcTextForTask2 


“Task 2 is running\t\n”; 


int main( void ) 


{ 


/* Create one of the two tasks. */ 








xTaskCreate( vTaskFunction, /* 指向 任务 函数 的 指针 . */ 
"Task 1", /* 任务 名 . */ 
1000, /* BRE. */ 
(void*)pcTextForTaskl, /* 通过 任务 参数 传 入 需要 打印 输出 的 文本 . */ 
1, /* 此 任务 运行 在 优先 级 1 上 . */ 
NULL ); /* 不 会 用 到 此 任务 的 句柄 */ 


/* 同样 的 方法 创建 另 一 个 任务 。 至 此 ， 由 相同 的 任务 代码 (vTaskFunction) 创建 了 多 个 任务 ， 仅 仅 是 传 入 


的 参数 不 同 。 同 一 个 任务 创建 了 两 个 实例 。 */ 
xTaskCreate( vTaskFunction, "Task 2", 1000, (void*)pcTextForTask2, 1, NULL ) 











/* Start the scheduler so our tasks start executing. */ 


vTaskStartScheduler () ; 

/* If all is well then main() will never reach here as the scheduler will 
now be running the tasks. If main() does reach here then it is likely that 
there was insufficient heap memory available for the idle task to be created. 


CHAPTER 5 provides more information on memory management. */ 


for( ;; Jj 


程序 清单 9 例 2 中 的 main() 函 数 实现 代码 


例 2 的 运行 输出 结果 与 例 1 完全 一 样 ， 参 见 图 2。 
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1.5 任务 优先 级 





xTaskCreate() API 函数 的 参数 uxPriority 为 创建 的 任务 赋予 了 一 个 初始 优先 级 。 这 
个 优先 级 可 以 在 调度 器 启动 后 调用 vTaskPrioritySet() API 函数 进行 修改 。 

应 用 程序 在 文件 FreeRTOSConfig.h 中 设 定 的 编译 时 配置 常量 
configMAX_PRIORITIES 的 值 ， 即 是 最 多 可 具有 的 优先 级 数目 。FreeRTOS 本 身 并 没 
有 限定 这 个 常量 的 最 大 值 ， 但 这 个 值 越 大 ， 则 内 核 花 销 的 内 存 空间 就 越 多 。 所 以 总 是 建 
议 将 此 常量 设 为 能 够 用 到 的 最 小 值 。 

对 于 如 何 为 任务 指定 优先 级 ,FreeRTOS 并 没有 强加 任何 限制 。 任意 数量 的 任务 可 
以 共享 同一 个 优先 级 一 一 以 保证 最 大 设计 弹性 。 当 然 ， 如 果 需 要 的 话 ， 你 也 可 以 为 每 个 
任务 指定 唯一 的 优先 级 (就 如 同 某 些 调度 算法 的 要 求 一 样 )， 但 这 不 是 强制 要 求 的 。 

低 优先 级 号 表示 任务 的 优先 级 低 , 优先 级 号 0 表示 最 低 优先 级 。 有 效 的 优先 级 号 范 
围 从 0 到 (configMAX_PRIORITES - 1). 

调度 器 保证 总 是 在 所 有 可 运行 的 任务 中 选择 具有 最 高 优先 级 的 任务 , 并 使 其 进入 运 
行 态 。 如 果 被 选中 的 优先 级 上 具有 不 止 一 个 任务 ， 调 度 器 会 让 这 些 任务 轮流 执行 。 这 种 
行为 方式 在 之 前 的 例子 中 可 以 明显 看 出 来 。 两 个 测试 任务 被 创建 在 同一 个 优先 级 上 ,并 
且 一 直 是 可 运行 的 。 所 以 每 个 任务 都 执行 一 个 "时 间 片 *， 任 务 在 时 间 片 起 始 时 刻 进入 运 
行 态 , 在 时 间 片 结束 时 刻 又 退出 运行 态 。 图 3 中 1 与 论 之 间 的 时 段 就 等 于 一 个 时 间 片 。 
要 能 够 选择 下 一 个 运行 的 任务 ， 调 度 器 需要 在 每 个 时 间 片 的 结束 时 刻 运 行 自 己 本 
身 。 一 个 称 为 心跳 (tick， 有 些 地 方 被 称 为 时 钟 滴答 ， 本 文中 一 律 称 为 时 钟 心跳 ) 中 断 的 
周期 性 中 断 用 于 此 目的 。 时 间 片 的 长 度 通 过 心跳 中 断 的 频率 进行 设 定 ， 心跳 中 断 频 率 由 
FreeRTOSConfig.h 中 的 编译 时 配置 常量 configTICK_RATE_HZ 进行 配置 。 比 如 说 ， 
如 果 configTICK_RATE_HZ 设 为 100(HZ)， 则 时 间 片 长 度 为 10ms。 可 以 将 图 3 进行 
扩展 ， 将 调度 器 本 身 的 执行 时 间 在 整个 执行 流程 中 体现 出 来 。 请 参见 图 4。 

需要 说 明 的 是 ，FreeRTOS API 函数 调用 中 指定 的 时 间 总 是 以 心跳 中 断 为 单位 〈 通 
常 的 提 法 为 心跳 ticks”)。 常 量 portTICK RATE MS 用 于 将 以 心跳 为 单位 的 时 间 值 转化 
为 以 毫秒 为 单位 的 时 间 值 。 有 效 精度 依 束 于 系统 心跳 频率 。 

心跳 计数 (tick count) 值 表示 的 是 从 调度 器 启动 开始 ， 心跳 中 断 的 总 数 ， 并 假定 心跳 
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计数 器 不 会 溢出 。 用 户 程序 在 指定 延迟 周期 时 不 必 考 虑 心跳 计数 溢出 问题 ， 因 为 时 间 连 





贯 性 在 内 核 中 进行 管理 。 
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图 4 对 执行 流程 进行 扩展 以 显示 心跳 中 断 的 执行 
图 4 中 红色 的 线段 表 时 内 核 本 身 在 运行 。 黑色 箭头 表示 任务 到 中 断 , 中 断 再 到 另 一 


个 任务 的 执行 顺序 。 


例 3. 优先 级 实验 








调度 器 总 是 在 可 运行 的 任务 中 ， 选 择 具 有 最 高 优 级 级 的 任务 ， 并 使 其 进入 运行 态 。 
到 目前 为 止 的 示例 程序 中 ， 两 个 任务 都 创建 在 相同 的 优先 级 上 。 所 以 这 两 个 任务 轮番 进 
入 和 退出 运行 态 。 本 例 将 改变 例 2 其 中 一 个 任务 的 优先 级 ， 看 一 下 倒 底 会 发 生 什 么 。 现 
在 第 一 个 任务 创建 在 优先 级 1 上 , 而 男 一 个 任务 创建 在 优先 级 2 上 。 创建 这 两 个 任务 的 
代码 参见 程序 清单 10。 这 两 个 任务 的 实现 函数 没有 任何 改动 ， 还 是 通过 空 循环 产生 延 





迟 来 周期 性 打印 输出 字符 串 。 
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H 





/* 定义 将 要 通过 任务 参数 传递 的 字符 串 。 定 义 为 const， 且 不 是 在 栈 空间 上 ， 以 保证 任务 执行 时 也 有 效 。 */ 


static const char *pcTextForTask1l = "Task 1 is running\r\n’; 








static const char *pcTextForTask2 = "Task 2 is running\t\n’; 


int main( void ) 


( 
/* 第 一 个 任务 创建 在 优先 级 1 上 。 优 先 级 是 倒数 第 二 个 参数 。 */ 
xTaskCreate( vTaskFunction, "Task 1", 1000, (void*)pcTextForTaskl, 1, NULL ); 
/* 第 二 个 任务 创建 在 优先 级 2 上 。 */ 
xTaskCreate( vTaskFunction, "Task 2", 1000, (void*)pcTextForTask2, 2, NULL ); 
/* Start the scheduler so the tasks start executing. */ 
vTaskStartScheduler () ; 
return 0; 

} 


程序 清单 10 ”两 个 任务 创建 在 不 同 的 优先 级 上 





图 5 是 例 3 的 运行 结果 。 
c C\WINDOWS\system32\cmd.exe - rtosdemo 
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图 5 ”两 个 测试 任务 运行 在 不 同 的 优先 级 上 








调度 器 总 是 选择 具有 最 高 优先 级 的 可 运行 任务 来 执行 。 任 务 2 的 优先 级 比 任务 
高 ， 并 且 总 是 可 运行 , 因此 任务 2 是 唯一 一 个 一 直 处 于 运行 态 的 任务 。 而 任务 1 不 可 能 
进入 运行 态 ， 所 以 不 可 能 输出 字符 串 。 这 种 情况 我 们 称 为 任务 1 的 执行 时 间 被 任务 2” 
(KE (starved)’ T . 

任务 2 之 所 以 总 是 可 运行 ， 是 因为 其 不 会 等 竺 任何 事情 一 一 它 要 么 在 空 循环 里 打 
转 ， 要 么 往 终端 打印 字符 串 。 
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图 6 展现 了 例 3 的 执行 流程 。 




















The scheduler runs in the tick interrupt | 
Tick ~} | but selects the same task. Task 2 is 
interrupt always in the Running state and Task 1 is 
occurs always in the Not Running state 
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Kle 当 一 个 任务 优先 比 另 一 个 高 时 的 执行 流程 
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1.6 扩充 “ 非 运行 态 ” 








到 目前 为 止 所 有 用 到 的 示例 中 , 创建 的 每 个 任务 都 上 只顾 不 停 地 处 理 上 自己 的 事情 而 没 
有 其 它 任 何事 情 需 要 等 待 一 一 由 于 它们 不 需要 等 待 所 以 总 是 能 够 进入 运行 态 。 这 种 "不 
停 处 理 " 类 型 的 任务 限制 了 其 有 用 性 ， 因 为 它们 只 可 能 被 创建 在 最 低 优先 级 上 。 如 何 它 
们 运行 在 其 它 任何 优先 级 上 ， 那 么 比 它们 优先 级 更 低 的 任务 将 永远 没有 执行 的 机 会 。 

为 了 使 我 们 的 任务 切实 有 用 , 我 们 需要 通过 某 种 方式 来 进行 事件 驱动 。 一 个 事件 驱 
动 任务 只 会 在 事件 发 生 后 触发 工作 (处 理 )， 而 在 事件 没有 发 生 时 是 不 能 进入 运行 态 的 。 
调度 器 总 是 选择 所 有 能 够 进入 运行 态 的 任务 中 具有 最 高 优先 级 的 任务 。 一 个 高 优先 级 但 
不 能 够 运行 的 任务 意味 着 不 会 被 调度 器 选中 , 而 代 之 以 男 一 个 优先 级 虽然 更 低 但 能 够 运 
行 的 任务 。 因 此 , 采用 事件 驱动 任务 的 意义 就 在 于 任务 可 以 被 创建 在 许多 不 同 的 优先 级 
上 ， 并 且 最 高 优先 级 任务 不 会 把 所 有 的 低 优先 级 任务 饿 死 。 

























































































阻塞 状态 
如 果 一 个 任务 正在 等 待 某 个 事件 ， 则 称 这 个 任务 处 于 ?阻塞 态 (blocked)”。 阻 塞 态 是 
非 运 行 态 的 一 个 子 状态 。 
任务 可 以 进入 阻塞 态 以 等 待 以 下 两 种 不 同类 型 的 事件 : 
1. 定时 (时 间 相 关 ) 事 件 一 一 这 类 事件 可 以 是 延迟 到 期 或 是 绝对 时 间 到 点 。 比 如 
说 某 个 任务 可 以 进入 阻塞 态 以 延迟 10ms。 
2. 同步 事件 一 一 源 于 其 它 任务 或 中 断 的 事件 。 比 如 说 ， 某 个 任务 可 以 进入 阻塞 
态 以 等 待 队 列 中 有 数据 到 来 。 同 步 事 件 面 括 了 所 有 板 级 范围 内 的 事件 类 型 。 
FreeRTOS 的 队列 ， 二 值 信号 量 ， 计 数 信 号 量 ， 互 斥 信号 量 (recursive semaphore, 
递归 信号 量 ， 本 文 一 律 称 为 互 斥 信号 量 ， 因 为 其 主要 用 于 实现 互 斥 访问 ) 和 互 斥 量 都 可 
以 用 来 实现 同步 事件 。 第 二 章 和 第 三 章 涵盖 了 有 关 这 些 的 详细 内 容 。 
任务 可 以 在 进入 阻塞 态 以 等 竺 同步 事件 时 指定 一 个 等 待 超时 时 间 , 这 样 可 以 有 效 地 
实现 阻塞 状态 下 同时 等 待 两 种 类 型 的 事件 。 比 如 说 ， 某 个 任务 可 以 等 待 队列 中 有 数据 到 
来 , 但 最 多 只 等 10ms。 如 果 10ms 内 有 数据 到 来 , 或 是 10ms 过 去 了 还 没有 数据 到 来 ， 
这 两 种 情况 下 该 任务 都 将 退出 阻塞 态 。 
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“ 挂 起 (suspended)" 也 是 非 运行 状态 的 子 状 态 。 处 于 挂 起 状态 的 任务 对 调度 器 而 言 
是 不 可 见 的 。 让 一 个 任务 进入 挂 起 状态 的 唯一 办 法 就 是 调用 VTaskSuspend() API 函数 ; 
而 把 一 个 挂 起 状态 的 任务 唤醒 的 唯一 途径 就 是 调用 vTaskResume() 或 
vTaskResumeFromISR() API 函数 。 大 多 数 应 用 程序 中 都 不 会 用 到 挂 起 状态 。 








如 果 任务 处 于 非 运行 状态 , 但 既 没 有 阻塞 也 没有 挂 起 , 则 这 个 任务 处 于 就 绪 (ready， 
准备 或 就 绪 ) 状 态 。 处 于 就 绪 态 的 任务 能 够 被 运行 ， 但 只 是 "准备 (ready) 运行 ， 而 当前 





完整 的 状态 转移 图 

图 7 对 之 前 那个 过 于 简单 的 状态 图 进行 了 扩充 ,包含 了 本 节 描 述 的 非 运 行 状态 的 子 
状态 。 目 前 为 止 所 有 用 到 的 示例 程序 中 创建 的 任务 都 还 没有 用 到 阻塞 状态 和 挂 起 状态 ， 
仅仅 是 在 就 绪 状 态 和 运行 状态 之 | 以 粗 线 进行 醒目 提示 。 





























| | ^ 
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例 4. 利用 阻塞 态 实现 延迟 

之 前 的 示例 中 所 有 创建 的 任务 都 是 "周期 性 ”的 一 一 它们 延迟 一 个 周期 时 间 ， 打 印 输 
出 字符 串 ， 再 一 次 延迟 ， 如 此 周而复始 。 而 产生 延迟 的 方法 也 相当 原始 地 使 用 了 空 循环 
一 个 循环 计数 直至 计 到 某 个 指定 值 。 例 3 明确 的 指出 了 这 种 方法 
的 缺点 。 一 直 保持 在 运行 态 中 执行 空 循环 ， 可 能 将 其 它 任务 饿 死 。 

其 实 以 任何 方式 的 查询 都 不 仅仅 只 是 低 效 , 还 有 各 种 其 它 方面 的 缺点 。 在 查询 过 程 
中 ， 任 务实 际 上 并 没有 做 任何 有 意义 的 事情 ， 但 它 依然 会 耗 尽 所 有 处 理 时 间 ， 对 处 理 器 
周期 造成 浪费 。 例 4 通过 调用 vTaskDelay() API 函数 来 代替 空 循环 ， 对 这 种 "不 良 行为 ” 
进行 纠正 。VvTaskDelay() 的 函数 原型 见 程序 清单 1{1， 而 新 的 任务 实现 见 程序 清单 12。 

























































































void vTaskDelay( portTickType xTicksToDelay ); 


程序 清单 11 vTaskDelay() API 函数 原型 


#2 vTaskDelay() 参 数 





xTicksToDelay 延迟 多 少 个 心路 周期 。 调 用 该 延迟 函数 的 任务 将 进入 阻塞 态 ， 经 
延迟 指定 的 心跳 周期 数 后 ， 再 转移 到 就 绪 态 。 





举 个 例子 ， 当 某 个 任务 调用 vTaskDelay( 100 ) 时 ， 心 跳 计 数值 
为 10,000， 则 该 任务 将 保持 在 阻塞 态 ， 直 到 心跳 计数 计 到 
10,100。 





常数 portTICK_RATE_MS 可 以 用 来 将 以 毫秒 为 单位 的 时 间 值 转 
换 为 以 心跳 周期 为 单位 的 时 间 值 。 











FreeRTOS 23 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http:/www.FreeRTOS.org 


void vTaskFunction( void *pvParameters ) 


{ 


char *pcTaskName; 


/* The string to print out is passed in via the parameter. Cast this to a 
character pointer. */ 


pcTaskName = ( char * ) pvParameters; 


/* As per most tasks, this task is implemented in an infinite loop. */ 


for( ;; ) 












































{ 
/* Print out the name of this task. */ 
vPrintString( pcTaskName ); 
/* 延迟 一 个 循环 周期 。 调 用 vTaskDelay () 以 让 任务 在 延迟 期 间 保持 在 阻塞 态 。 延 迟 时 间 以 心跳 周期 为 
单位 ， 常 量 portTICK_RRATE_MS 可 以 用 来 在 毫秒 和 心跳 周期 之 间 相 换 转 换 。 本 例 设 定 250 毫 秒 的 循环 周 
B. */ 
vTaskDelay( 250 / portTICK RATE MS ); 

} 


程序 清单 12 ”调用 vTaskDelay() 来 代替 空 循环 实现 延迟 














尽管 两 个 任务 实例 还 是 创建 在 不 同 的 优先 级 上 ， 但 现在 两 个 任务 都 可 以 得 到 执行 。 
例 4 的 运行 输出 结果 参见 图 8。 
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图 9 所 示 的 执行 流程 可 以 解释 为 什么 此 时 不 同 优先 级 的 两 个 任务 竟然 都 可 以 得 到 
执行 。 图 中 为 了 简便 ， 忽 略 了 内 核 自 身 的 执行 时 间 。 
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空闲 任务 是 在 调度 器 局 动 时 自动 创建 的 ， 以 保证 全 少 有 一 个 任务 可 运行 (至 少 有 一 
个 任务 处 于 就 绪 态 )。 本 章 第 7 节 会 对 空闲 任务 进行 更 详细 的 描述 。 





4- When the delay expires the scheduler moves the 

2 - Task 1 prints out its string, then it too | tasks back into the ready state, where both execute 

enters the Blocked state by calling again before once again calling vTaskDelay() causing 

vTaskDelay(). them to re-enter the Blocked state. Task 2 executes 
/ first as it has the higher priority. 

















Task 1 
Task 2 
Idle 





tt [^ 13 Time tn 














1 - Task 2 has the highest priority so runs first. It à 
prints out its string then calls vTaskDelay() - and in so | |3-Atthis point both application tasks are in 
doing enters the Blocked state, permitting the lower the Blocked state - so the Idle task runs. 

priority Task 1 to execute. 

















图 9 用 vTaskDelay() 代 替 空 循环 后 的 执行 流程 


本 例 是 只 改变 了 两 个 任务 的 实现 方式 , 并 没有 改变 其 功能 。 对 比 图 9 与 图 4 可 以 清 
晰 地 看 到 本 例 以 更 有 效 的 方式 实现 了 任务 的 功能 。 

图 4 展现 的 是 当 任 务 采 用 空 循环 进行 延迟 时 的 执行 流程 一 一 结果 就 是 任务 总 是 可 
运行 并 占用 了 大 量 的 机 器 周期 。 从 图 9 中 的 执行 流程 中 可 以 看 到 , 任务 在 整个 延迟 周期 
内 都 处 于 阻塞 态 ， 只 在 完成 实际 工作 的 时 候 才 占用 处 理 器 时 间 ( 本 例 中 任务 的 实际 工作 
只 是 简单 地 打印 输出 一 条 信息 )。 

在 图 9 所 示 的 情形 中 ， 任 务 离开 阻塞 态 后 ， 仅 仅 执行 了 一 个 心路 周期 的 一 个 片段 ， 
然后 又 再 次 进入 阻塞 态 。 所 以 大 多 数 时 间 都 没有 一 个 应 用 任务 可 运行 ( 即 没有 应 用 任务 
处 于 就 绪 态 )， 因 此 没有 应 用 任务 可 以 被 选择 进入 运行 态 。 这 种 情况 下 ， 空 闲 任务 得 以 
执行 。 空 间 任务 可 以 获得 的 执行 时 间 量 ， 是 系统 处 理 能 力 裕 量 的 一 个 度量 指标 。 

图 10 中 的 粗 线条 表示 例 4 中 任务 的 状态 转移 过 程 。 现 在 每 个 任务 在 返回 就 绪 态 之 

， 都 会 经 过 阻塞 状态 。 
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图 10 粗 线条 表示 例 4 中 的 状态 转移 过 程 


vTaskDelayUntil() API 函数 

vTaskDelayUntil() 类 似 于 vTaskDelay()。 和 范例 中 演示 的 一 样 ， 函 数 vTaskDelay() 
的 参数 用 来 指定 任务 在 调用 vTaskDelay() 到 切 出 阻塞 态 整 个 过 程 包含 多 少 个 心跳 周期 。 
任务 保持 在 阻塞 态 的 时 间 量 由 vTaskDelay() 的 入 口 参数 指定 , 但 任务 离开 阻塞 态 的 时 刻 
实际 上 是 相对 于 vTaskDelay() 被 调用 那 一 刻 的 。vTaskDelayUntil() 的 参数 就 是 用 来 指定 
任务 离开 阻塞 态 进入 就 绪 态 那 一 刻 的 精确 心跳 计数 值 。 API 函数 vTaskDelayUntil() 可 以 
用 于 实现 一 个 固定 执行 周期 的 需求 ( 当 你 需要 让 你 的 任务 以 固定 频率 周期 性 执行 的 时 
候 )。 由 于 调用 此 函数 的 任务 解除 阻塞 的 时 间 是 绝对 时 刻 ， 比 起 相对 于 调用 时 刻 的 相对 
时 间 更 精确 ( 即 比 调用 vTaskDelay() 可 以 实现 更 精确 的 周期 性 )。 




















~ 















































void vTaskDelayUntil( portTickType * pxPreviousWakeTime, portTickType xTimeIncrement ) ; 


程序 清单 13 vTaskDelayUntil() API 函数 原型 
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K 3 vTaskDelayUntil() 22 


参数 名 描述 


pxPreviousWakeTime ”此 参数 命名 时 假定 vTaskDelayUntil() 用 于 实现 某 个 任务 以 
固定 频率 周期 性 执行 。 这 种 情况 下 pxPreviousWakeTime 
保存 了 任务 上 一 次 离开 阻塞 态 (被 唤醒 ) 的 时 刻 。 这 个 时 刻 
被 用 作 一 个 参考 点 来 计算 该 任务 下 一 次 离开 阻塞 态 的 时 


刻 。 








pxPreviousWakeTime 指向 的 变量 值 会 在 API 函数 
vTaskDelayUntil() 调 用 过 程 中 自动 更 新 ， 应 用 程序 除了 该 
变量 第 一 次 初始 化 外 ， 通 常 都 不 要 修改 它 的 值 。 程 序 清单 
14 展示 了 这 个 参数 的 使 用 方法 。 









































xTimelncrement 此 参数 命名 时 同样 是 假定 vTaskDelayUntil() 用 于 实现 某 个 
任务 以 固定 频率 周期 性 执行 一 一 这 个 频率 就 是 由 





xTimelncrement 指定 的 。 





xTimelncrement 的 单位 是 心跳 周期 ， 可 以 使 用 常 
portTICK_RATE_MS 将 毫秒 转换 为 心跳 周期 。 


Hh 








fj 5. 转换 示例 任务 使 用 vTaskDelayUntil() 

il 4 中 的 两 个 任务 是 周期 性 任务 , 但 是 使 用 vTaskDelay() 无 法 保证 它们 具有 固定 的 
执行 频率 ,因为 这 两 个 任务 退出 阻塞 态 的 时 刻 相对 于 调用 vTaskDelay() 的 时 刻 。 通过 调 
用 vTaskDelayUntil() 代 替 vTaskDelay(), 把 这 两 个 任务 进行 转换 ， 以 解决 这 个 潜在 的 问 


题 。 
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void vTaskFunction( void *pvParameters ) 
char *pcTaskName; 


portTickType xLastWakeTime; 


/* The string to print out is passed in via the parameter. Cast this toa 
character pointer. */ 


pceTaskName = ( char * ) pvParameters; 


/* 变量 xLastWakeTime 需 要 被 初始 化 为 当前 心跳 计数 值 。 说 明 一 下 , 这 是 该 变量 唯一 一 次 被 显 式 赋值 之后， 
xLastWakeTime 将 在 函数 vTaskDelayUntil () 中 自动 更 新 。 */ 
xLastWakeTime = xTaskGetTickCount () ; 





/* As per most tasks, this task is implemented in an infinite loop. */ 
for( ;; ) 
/* Print out the name of this task. */ 


vPrintString( pcTaskName ); 




















/* 本 任务 将 精确 的 以 250 毫 秒 为 周期 执行 。 同 vTaskDelay O 函数 一 样 , 时 间 值 是 以 心跳 周期 为 单位 的 ， 
可 以 使 用 常量 portTICK_RATE_MS 将 毫秒 转换 为 心跳 周期 。 变 量 xLastWakeTime 会 在 
vTaskDelayUntil() 中 自动 更 新 ， 因 此 不 需要 应 用 程序 进行 显示 更 新 。 */ 

vTaskDelayUntil( &xLastWakeTime, ( 250 / portTICK RATE MS ) ); 









































程序 清单 14 ”使 用 vTaskDelayUntil() 实 现 示 例 任务 


例 5 的 运行 输出 与 例 4 完全 相同 ， 请 参考 图 8。 





例 6. 合并 阻塞 与 非 阻塞 任务 
之 前 的 范例 分 别 测试 了 任务 以 查询 方式 和 阻塞 方式 工作 的 系统 行为 。 本 例 通 过 合并 
这 两 种 方案 的 执行 流程 ， 再 次 实现 具有 既定 预期 的 系统 行为 。 








。 在 优先 级 1 上 创建 两 个 任务 。 这 两 个 任务 只 是 不 停 地 打印 输出 字符 串 ， 然 它 什 么 
事情 也 不 做 。 


这 两 个 任务 没有 调用 任何 可 能 导致 它们 进入 阻塞 态 的 API 函数 ,所 以 这 两 个 任务 
要 么 处 于 就 绕 态 ， 要 么 处 于 运行 态 。 共 有 这 种 性 质 的 任务 被 称 为 "不 停 处 理 (或 持 
续 处 理 ，continuous processing)" 任 务 ， 因 为 它们 总 是 有 事情 要 做 ,虽然 在 本 例 
中 的 它们 做 的 事情 没什么 意义 。 持 续 处 理 任 务 的 源 代码 参见 程序 清单 15。 
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。 第 三 个 任务 创建 在 优先 级 2 上 ， 高 于 另外 两 个 任务 的 优先 级 。 这 个 任务 虽然 也 是 
打印 输出 学 符 串 ,但 它 是 周期 性 的 ， 所 以 调用 了 vTaskDelayUntil(), 在 每 两 次 打 
印 之 间 让 自己 处 于 阻塞 态 。 


周期 性 任务 的 实现 代码 参见 程序 清单 16。 


void vContinuousProcessingTask( void *pvParameters ) 


{ 


char *pcTaskName; 








/* 打印 输出 的 字符 串 由 任务 参数 传 入 ， 强 制 转换 为 chnarx */ 


pcTaskName = ( char * ) pvParameters; 

















/* As per most tasks, this task is implemented in an infinite loop. */ 
for( ;; ) 
{ 

/* 打印 输出 任务 名 ， 无 阻塞 ， 也 无 延迟 。 */ 

vPrintString( pcTaskName ); 


程序 清单 15 ” 例 6 中 持续 处 理 任务 的 实现 代码 


void vPeriodicTask( void *pvParameters ) 


{ 


portTickType xLastWakeTime; 


/* 初始 化 xLastWakeTime, 之 后 会 在 vTaskDelayUntil() 中 自动 更 新 。 */ 
xLastWakeTime = xTaskGetTickCount () ; 


/* As per most tasks, this task is implemented in an infinite loop. */ 
for( ;; ) 
/* Print out the name of this task. */ 


vPrintString( "Periodic task is running\r\n" ); 
/* The task should execute every 10 milliseconds exactly. */ 
vTaskDelayUntil( &xLastWakeTime, ( 10 / portTICK RATE MS ) ); 


程序 清单 16 ” 例 6 中 周期 任务 的 实现 代码 
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图 11 展示 了 例 6 的 运行 输出 结果 ， 图 12 是 对 看 到 的 行为 方式 对 应 的 执行 流程 的 
解释 。 





t5 DOSBox 0.72, Cpu Cycles: 3000, Frameskip 0, Program: RTOSDEMO 
Continuous task 2 ruming 
Continuous task 2 running 
2 running 
k is running 
running 
running 
running 
running 
running 
running 
running 
rum ing 


rum ing 


ruming 
ruming 
Continuous te running 
Cont inuous 3 running 
C i running 
running 


Cont inuous 1 running 











图 11 例 6 的 执行 输出 结果 ' 
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2 一 在 心跳 中 断 期 
运行 . 由 于 两 个 持续 
并 且 都 总 是 可 运行 ， 
器 时 间 , 所 以 持续 人 
整 的 心跳 周期 一 

多 次 输出 它 的 字符 











图 12 例 6 的 执行 流程 

















"此 输出 使 用 DOSBox 模拟 器 降低 了 执行 速度 ， 以 便 在 单 幅 屏幕 上 观察 到 完整 的 系统 行为 。 
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1.7 空闲 任务 与 空闲 任务 钩子 函数 











例 4 中 创建 的 任务 大 部 份 时 间 都 处 于 阻塞 态 。 这 种 状态 下 所 有 的 任务 都 不 可 运行 ， 
所 以 也 不 能 被 调度 器 选中 。 

但 处 理 器 总 是 需要 代码 来 执行 一 一 所 以 至 少 要 有 一 个 任务 处 于 运行 态 。 为 了 保证 这 
一 点 ， 当 调用 vTaskStartScheduler() 时 ， 调 度 器 会 自动 创建 一 个 空闲 任务 。 空 闲 任务 是 
一 个 非常 短小 的 循环 一 一 和 最 早 的 示例 任务 十 分 相似 ， 总 是 可 以 运行 。 

空闲 任务 拥有 最 低 优先 级 (优先 级 0) 以 保证 其 不 会 妨碍 具有 更 高 优先 级 的 应 用 任务 
进入 运行 态 一 一 当然 , 没有 任何 限制 说 是 不 能 把 应 用 任务 创建 在 与 空闲 任务 相同 的 优先 
级 上 ; 如 果 需 要 的 话 ， 你 一 样 可 以 和 空闲 任务 一 起 共享 优先 级 。 

运行 在 最 低 优先 级 可 以 保证 一 旦 有 更 高 优先 级 的 任务 进入 就 绪 态 , 空闲 任务 就 会 立 
即 切 出 运行 态 。 这 一 点 可 以 在 图 9 的 tn 时 刻 看 出 来 ， 当 任务 2 退出 阻塞 态 时 ， 空 闲 任 
务 立 即 切换 出 来 以 让 任务 2 执行 。 任务 2 被 看 作 是 抢占 (pre-empted) 了 空闲 任务 。 抢 占 
是 自动 发 生 的 ， 也 并 不 需要 通知 被 抢占 任务 。 















































空闲 任务 钩子 函数 
通过 空闲 任务 钧 子 函数 (或 称 回调 ，hook, or call-back)， 可 以 直接 在 空闲 任务 中 添 
加 应 用 程序 相关 的 功能 。 空 闲 任务 钧 子 函 数 会 被 空闲 任务 每 循环 一 次 就 自动 调用 一 次 。 
通常 空闲 任务 钩子 函数 被 用 于 : 





























© 执行 低 优先 级 ， 后 台 或 需要 不 停 处 理 的 功能 代码 。 














。 测 试 处 系统 处 理 裕 量 ( 空 闲 任务 只 会 在 所 有 其 它 任务 都 不 运行 时 才 有 机 会 执行 ， 所 
以 测量 出 空闲 任务 占用 的 处 理 时 间 就 可 以 清楚 的 知道 系统 有 多 少 富余 的 处 理 时 
间 ) 。 



























































。 将 处 理 器 配置 到 低 功 耗 模式 一 一 提供 一 种 自动 省 电 方法 ， 使 得 在 没有 任何 应 用 功能 
需要 处 理 的 时 候 ， 系 统 自 动 进入 省 电 模 式 。 
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"E AES IT^ PRBS SCELERE n 
空闲 任务 钩子 函数 必须 遵从 以 下 规则 








1. 绝 不 能 阻 或 挂 起 。 空 闲 任务 只 会 在 其 它 任务 都 不 运行 时 才 会 被 执行 (除非 有 应 用 任 
享 空闲 任务 优先 级 )。 以 任何 方式 阻塞 空闲 任务 都 可 能 导致 没有 任务 能 够 进入 


务 共享 
运行 态 ! 





ES 





2 如果 应 用 程序 用 到 了 vTaskDelete() AP rit, Jl A £5 37 PR do i FE JS aa [FT s 
因为 在 任务 被 删除 后 ， 空 闲 任务 负责 回收 内 核资 源 。 如 果 空 闲 任务 一 直 运 行 在 钩 
子 函 数 中 ， 则 无 法 进行 回收 工作 。 





空闲 任务 钩子 函数 必须 具有 程序 清单 17 所 示 的 函数 名 和 函数 原型 。 











void vApplicationIdleHook( void ); 


程序 清单 17 ”空闲 任务 钩子 函数 原型 


例 7. 定义 一 个 空闲 任务 钓 子 函数 

例 4 调用 了 带 阻 塞 性 质 的 vTaskDelay() API 函数 ， 会 产生 大 量 的 空闲 时 间 在 
这 期 间 空闲 任务 会 得 到 执行 ， 因 为 两 个 应 用 任务 均 处 于 阻塞 态 。 本 例 通 过 空闲 钧 子 函数 
来 使 用 这 些 空间 时 间 。 具 体 源 代码 参见 程序 清单 18。 




















/* Declare a variable that will be incremented by the hook function. */ 


unsigned long ulIdleCycleCount = OUL; 


/* "BREST ERU 4 AvApplicationIdleHook () ,无 参数 也 无 返回 值 。 */ 
void vApplicationIdleHook( void ) 


/* This hook function does nothing but increment a counter. */ 


ulIdleCycleCount++; 


程序 清单 18 — SSE RS TR BUT AF E 
FreeRTOSContfig.h 中 的 配置 常量 configUSE. IDLE. HOOK 必须 定义 为 1, 这 样 空 
朵 任务 钧 子 函 数 才 会 被 调用 。 
对 应 用 任务 实现 函数 进行 了 少量 的 修改 ， 用 以 打印 输出 变量 ulldleCycleCount 的 
值 ， 如 程序 清单 19 所 示 。 


FreeRTOS 32 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 



































http:/www.FreeRTOS.org 


void vTaskFunction( void *pvParameters ) 


{ 


char *pcTaskName; 


/* The string to print out is passed in via the parameter. Cast this to a 
character pointer. */ 


pcTaskName = ( char * ) pvParameters; 


/* As per most tasks, this task is implemented in an infinite loop. */ 
for( ;; ) 
{ 
/* 打印 输出 任务 名 ， 以 及 调用 计数 器 ulIdlecyclecount 的 值 。 */ 
vPrintStringAndNumber( pcTaskName, ulIdleCycleCount ); 


/* Delay for a period for 250 milliseconds. */ 


vTaskDelay( 250 / portTICK RATE MS ); 


程序 清单 19 示例 任务 现在 用 于 打印 输出 ulldleCycleCount 的 值 





例 7 的 输出 结果 参见 图 13。 从 图 中 可 以 看 出 (在 我 的 电脑 上 ), 空闲 任务 钩子 函数 在 
应 用 任务 的 每 次 循环 过 程 中 被 调用 了 (非常 ) 接 近 4.5 million 次 。 





c\ C\WINDOWS \system32\cmd.exe - rtosdemo - 


C:\Temp>rtosdemo 

Task 2 is running 

uli dleCyc leCount 

Task 1 is running 
ulIdleCycleCount = @ 

Task 2 is running 
ulIdleCycleCount = 3869564 
Task 1 is running 
ulIdleCycleCount = 3869564 
Task 2 is running 
ulIldleCycleCount = 8564623 
Task 1 is running 
ulldleCycleCount = 8564623 
Task 2 is running 
ulldleCycleCount = 13181489 
Task 1 is running 
ulldleCycleCount = 13181489 
Task 2 is running 
ulldleCycleCount = 17838406 
Task 1 is running 
ulIdleCycleCount = 17838406 








图 13 47 的 运行 输出 结果 


FreeRTOS 33 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http://www.FreeRTOS.org 


1.8 改变 任务 优先 级 


vTaskPrioritySet() API 函数 
API 函数 vTaskPriofitySet() 可 以 用 于 在 调度 器 启动 后 改变 任何 任务 的 优先 级 。 


void vTaskPrioritySet( xTaskHandle pxTask, unsigned portBASE TYPE uxNewPriority ); 


程序 清单 20 vTaskPrioritySet() API 函数 原型 


表 4 vTaskPrioritySet() 参数 


参数 名 描述 
pxTask 被 修改 优先 级 的 任务 句柄 ( 即 目 标 任务 ) 一 一 参考 xTaskCreate() API 








函数 的 参数 pxCreatedTask 以 了 解 如 何 得 到 任务 句柄 方面 的 信息 。 








任务 可 以 通过 传 入 NULL 值 来 修改 自己 的 优先 级 。 





uxNewPriority ”目标 任务 将 被 设置 到 哪个 优先 级 上 。 如 果 设 置 的 值 超 过 了 最 大 可 用 优 

先 级 (configMAX_PRIORITIES - 1)， 则 会 被 自动 封顶 为 最 大 值 。 常 
量 configMAX_PRIORITIES 是 在 FreeRTOSConfig.h 头 文件 中 设置 
的 一 个 编译 时 选项 。 




















Im 








uxTaskPriorityGet() API 函数 
uxTaskPriorityGet() API 函数 用 于 查询 一 个 任务 的 优先 级 。 


unsigned portBASE TYPE uxTaskPriorityGet( xTaskHandle pxTask ); 


程序 清单 21 uxTaskPriorityGet() API 函数 原型 


FreeRTOS 34 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http://www.FreeRTOS.org 


K 5 uxTaskPriorityGet() 参 数 及 返回 值 








参数 名 描述 
pxTask 被 查询 任务 的 句柄 (目标 任务 ) 参考 xTaskCreate() API 函数 的 参数 





pxCreatedTask 以 了 解 如 何 得 到 任务 句柄 方面 的 信息 。 








任务 可 以 通过 传 入 NULL 值 来 查询 自己 的 优先 级 。 





返回 值 被 查询 任务 的 当前 优先 级 。 





例 8. 改变 任务 优先 级 

调度 器 总 是 在 所 有 就 绪 态 任务 中 选择 具有 最 高 优先 级 的 任务 ， 并 使 其 进入 运行 态 。 
本 例 即 是 通过 调用 vTaskPrioritySet() API 函数 来 改变 两 个 任务 的 相对 优先 级 ， 以 达到 
对 调度 器 这 一 行为 的 演示 。 

在 不 同 的 优先 级 上 创建 两 个 任务 。 这 两 个 任务 都 没有 调用 任何 会 令 其 进入 阻塞 态 的 
API 函数 ， 所 以 这 两 个 任务 要 么 处 于 就 绪 态 ， 要 么 处 于 运行 态 一 一 这 种 情形 下 ， 调 度 器 
选择 具有 最 高 优先 级 的 任务 来 执行 。 

例 8 具有 以 下 行为 方式 : 



































。 任 务 1( 程 序 清单 22) 创 建 在 最 高 优先 级 ， 以 保证 其 可 以 最 先 运行 。 任 务 1 首先 
打印 输出 两 个 字符 串 ， 然 后 将 任务 2( 程 序 清单 23) 的 优先 级 提升 到 上 自己 之 上 。 








。 任 务 2 一 旦 拥有 最 高 优先 级 便 启动 执行 (进入 运行 态 )。 由 于 任何 时 候 只 可 能 有 
一 个 任务 处 于 运行 态 ， 所 以 当 任 务 2 运行 时 ， 任 务 1 处 于 就 绪 态 。 











。 任 务 2 打印 输出 一 个 信息 ， 然 后 把 自己 的 优先 级 设 回 低 于 任务 1 的 初始 值 。 











。 任 务 2 降低 自己 的 优先 级 意味 着 任务 1 又 成 为 具有 最 高 优先 级 的 任务 ， 所 以 任 
务 1 重新 进入 运行 态 ， 任 务 2 被 强制 切入 就 绪 态 。 
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void vTaskl( void *pvParameters ) 


( 


unsigned portBASE TYPE uxPriority; 














/* 本 任务 将 会 比 任务 2 更 先 运 行 ， 因 为 本 任务 创建 在 更 高 的 优先 级 上 。 任 务 1 和 任务 2 都 不 会 阻塞 ， 所 以 两 者 要 
么 处 于 就 绪 态 ， 要 么 处 于 运行 态 。 

查询 本 任务 当前 运行 的 优先 级 - 传递 一 个 NULL 值 表示 说 “返回 我 自己 的 优先 级 ”。 */ 

uxPriority = uxTaskPriorityGet( NULL ); 














for( ;; ) 
t 
/* Print out the name of this task. */ 


vPrintString( "Taskl is running\r\n" ); 











/* 把 任务 2 的 优先 级 设置 到 高 于 任务 1 的 优先 级 ， 会 使 得 任务 2 立即 得 到 执行 (因为 任务 2 现在 是 所 有 任务 
中 具有 最 高 优先 级 的 任务 ) 。 注 意 调 用 vTaskPriorityset () 时 用 到 的 任务 2 的 句柄 。 程序 清单 24 将 展示 
如 何 得 到 这 个 句柄 。 */ 

vPrintString( "About to raise the Task2 priority\r\n" ); 






























































vTaskPrioritySet( xTask2Handle, ( uxPriority + 1 ) ); 














/* 本 任务 只 会 在 其 优先 级 高 于 任务 2 时 才 会 得 到 执行 。 因 此 ， 当 此 任务 运行 到 这 里 时 ， 任 务 2 必 然 已 经 执 
行 过 了 ， 并 且 将 其 自身 的 优先 级 设置 回 比 任务 1 更 低 的 优先 级 。 */ 
































程序 清单 22 Bil 8 中 任务 1 的 实现 代码 


void vTask2( void *pvParameters ) 


{ 


unsigned portBASE TYPE uxPriority; 











/* 任务 1 比 本 任务 更 先 启 动 ， 因 为 任务 1 创建 在 更 高 的 优先 级 。 任 务 1 和 任务 2 都 不 会 阻塞 ， 所 以 两 者 要 么 处 于 
就 绪 态 ， 要 么 处 于 运行 态 。 
查询 本 任务 当前 运行 的 优先 级 - 传递 一 个 NULL 值 表示 说 “返回 我 自己 的 优先 级 ”。 */ 
uxPriority = uxTaskPriorityGet( NULL ); 


























for( ;; ) 
{ 
/* 当 任 务 运 行 到 这 里 ， 任 务 1 必 然 已 经 运行 过 了 ， 并 将 本 身 务 的 优先 级 设置 到 高 于 任务 1 本 身 。 */ 


vPrintString( "Task2 is running\r\n" ); 





/* 将 自己 的 优先 级 设置 回 原来 的 值 。 传 递 NULIT 句 柄 值 意味 “改变 我 己 自 的 优先 级 ”。 把 优先 级 设置 到 低 
于 任务 1 使 得 任务 1 立即 得 到 执行 - 任务 1 抢占 本 任务 。 */ 


vPrintString( "About to lower the Task2 priority\r\n" ); 



































vTaskPrioritySet( NULL, ( uxPriority - 2 ) ); 


程序 清单 23 例 8 中 的 任务 2 实现 代码 
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任务 在 查询 和 修改 自己 的 优先 级 时 ， 并 没有 使 用 一 个 有 效 的 句柄 一 一 使 用 NULL 
代替 。 只 有 在 茶 个 任务 需要 引用 其 它 任务 的 时 候 才 会 用 到 任务 句柄 。 好 比 任务 1 想 要 改 
变 任务 2 的 优先 级 ， 为 了 让 任务 1 能 够 使 用 到 任务 2 的 句柄 ， 在 任务 2 被 创建 时 其 名 
柄 就 被 获得 并 保存 下 来 ， 就 像 程序 清单 24 注释 中 重点 提示 的 一 样 。 




















/* 声明 变量 用 于 保存 任务 2 的 句柄 。 */ 
xTaskHandle xTask2Handle; 








int main( void ) 


{ 
/* 任务 1 创建 在 优先 级 2 上 。 任 务 参数 没有 用 到 ， 设 为 NULL。 任 务 句柄 也 不 会 用 到 ， 也 设 为 NULL */ 
xTaskCreate( vTaskl, "Task 1", 1000, NULL, 2, NULL ); 


/* The task is created at priority 2 "i. oue 





/* 任务 2 创建 在 优先 级 1 上 - 此 优先 级 低 于 任务 1。 任 务 参数 没有 用 到 ， 设 为 NULD。 但 任务 2 的 任务 句柄 会 被 
用 到 ， 故 将 xTask2Handle 的 地 址 传 入 。 */ 
xTaskCreate( vTask2, "Task 2", 1000, NULL, 1, &xTask2Handle ); 





入 和 人 入 和 人 入 和 人 入 和 人 入 人 入 和 人 入 */ 


/* The task handle is the last parameter 


/* Start the scheduler so the tasks start executing. */ 


vTaskStartScheduler(); 


/* If all is well then main() will never reach here as the scheduler will 
now be running the tasks. If main() does reach here then it is likely that 
there was insufficient heap memory available for the idle task to be created. 
CHAPTER 5 provides more information on memory management. */ 


for( ;; ); 


程序 清单 24 例 8 中 main() 函 数 实现 代码 


图 14 展示 了 例 8 的 执行 流程 ， 例 8 的 运行 输出 结果 参见 图 15。 
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3 - Task1 runs again when|\ 
1- Task1 runs ^ Task2 lowers its own priority 
first as it has the back to being below the 
highest priority Task1 priority, and so on 


Task 1 
Task 2 





The Idle task never runs |N 
as both application tasks 
are always able to run and 
j| : | always have a priority 
idle 1 | above the idle priority 

















H Time ^ > 








2 - Task2 runs each 
time Task1 sets the 
Task2 priority to be 
the highest 





图 14 例 8 的 执行 流程 


priority 

sk2 priority 

2 priority 
priority 

e Task2 priority 


e Task2 priority 


s running 
0 lower the Task2 priority 


priority 


lower the T. priority 
running 
raise the Task2 priority 


to lower the Task2 priority 
is ruming 
raise the Task2 priority 











图 15 例 8 的 运行 输出 结果 
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1.9 删除 任务 


vTaskDelete() API 函数 
任务 可 以 使 用 API 函数 vVTaskDelete() 删 除 自己 或 其 它 任务 。 
任务 被 删除 后 就 不 复 存 在 ， 也 不 会 再 进入 运行 态 。 
空 闪 任务 的 责任 是 要 将 分 配给 已 删除 任务 的 内 存 释 放 掉 。 因 此 有 一 点 很 重要 ， 那 就 
是 使 用 vTaskDelete() API 函数 的 任务 千 万 不 能 把 空闲 任务 的 执行 时 间 钱 死 。 
需要 说 明 一 点 ， 只 有 内 核 为 任务 分 配 的 内 存 空间 才 会 在 任务 被 删除 后 自动 回收 。 任 
务 自 己 占用 的 内 存 或 资源 需要 由 应 用 程序 自己 显 式 地 释放 。 






























































void vTaskDelete( xTaskHandle pxTaskToDelete ); 


程序 清单 25 vTaskDelete() API 函数 原型 


K6 vTaskDelete() 参 数 


参数 名 描述 


pxTaskToDelete ”被 删除 任务 的 句柄 (目标 任务 ) () API 函数 的 
参数 pxCreatedTask 以 了 解 如 何 得 到 任务 句柄 方面 的 信息 。 











任务 可 以 通过 传 入 NULL 值 来 删除 自己 。 


例 9. 删除 任务 
这 是 一 个 非常 简单 的 范例 ， 其 行为 如 下 : 








。 任 务 1 则 main() 创 建 在 优先 级 1 E. 任务 1 运行 时 ， 以 优先 级 2 创建 任务 2. Hh 
在 任务 2 具有 最 高 优先 级 ， 所 以 会 立即 得 到 执行 。main() 函 数 的 源 代码 参见 程 
序 清单 26， 任 务 1 的 实现 代码 参见 程序 清单 27。 

















。 任 务 2 什么 也 没有 做 ， 只 是 删除 自己 。 可 以 通过 传递 NULL (HUI vTaskDelete() 
来 删除 自己 ， 但 是 为 了 纯粹 的 演示 ， 传 递 的 是 任务 自己 的 句柄 。 任 务 2 的 实现 
源 代码 见 程序 清单 28。 
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。 当 任务 2 被 自己 删除 之 后 ,任务 1 成 为 最 高 优先 级 的 任务 ， 所 以 继续 执行 ， 调 用 


VvTaskDelay() 阻 塞 一 小 段 时 间 。 





。 当 任务 1 进入 阻塞 状态 后 ,空闲 任 务 得 到 执行 的 机 会 。 空 闲 任务 会 释放 内 核 为 已 


删除 的 任务 2 分配 的 内 存 。 





。 任 务 1 离开 阻塞 态 后 , 再 一 次 成 为 就 绪 态 中 具有 最 高 优先 级 的 任务 ， 因 此 会 抢占 





空闲 任务 。 又 再 一 次 创建 任务 2， 如 此 往复 。 


int main( void ) 


{ 
/* 任务 1 创建 在 优先 级 1 上 */ 


xTaskCreate( vTaskl, "Task 1", 1000, NULL, 1, NULL ); 


/* The task is created at priority 1 Ta, def 


/* Start the scheduler so the tasks start executing. 


vTaskStartScheduler(); 


274 


/* main() should never reach here as the scheduler has been started. */ 


for( ;; ); 


程序 清单 26 例 9 中 的 main() 函 数 实现 


void vTaskl( void *pvParameters ) 


( 
const portTickType xDelay100ms = 100 / portTICK RATE MS; 
for( ;; ) 
{ 
/* Print out the name of this task. */ 


vPrintString( "Taskl is running\r\n" ); 


/* 创建 任务 2 为 最 高 优先 级 。 */ 


xTaskCreate( vTask2, "Task 2", 1000, NULL, 2, &xTask2Handle ); 


/* The task handle is the last parameter 




















/* 因为 任务 2 具有 最 高 优先 级 ， 所 以 任务 1 运行 到 这 里 时 ,任务 2 已 
执行 ， 延 迟 100ms */ 


vTaskDelay( xDelay100ms ); 








程序 清单 27 例 9 中 任务 1 的 实现 代码 
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入 和 人 和 人 和 入 人 人 和 入 人 和 入 wy 


成 执行 ， 删除 了 自己 。 任 务 1 得 以 


40 


© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http:/www.FreeRTOS.org 


void vTask2( void *pvParameters ) 


{ 


/* 任务 2 什么 也 没 做 , 只 是 删除 自己 。 删除 自己 可 以 传 入 NULL 值 , 这 里 为 了 演示 , 还 是 传 入 其 自己 的 句柄 。 


vPrintString( "Task2 is running and about to delete itself\r\n" ); 


vTaskDelete( xTask2Handle ); 


程序 清单 28 





例 9 中 的 任务 2 实现 代码 


c\ C\WINDOWS\system32\cmd.exe - rtosdemo 


Taskl is running 
Task2 i punning 
punning 

punning 

running 

running 

s running 
running 

running 

punning 

running 

running 

running 

running 

running 

punning 

punning 


running a 


running 
running 
running 


running 


running 


s running 


about 
about 
about 
about 
about 
about 
about 
about 
about 
about 
about 


about 


delete 
delete 
delete 
delete 
delete 
delete 
delete 
delete 
delete 
delete 
delete 


delete 


itself 
itself 
itself 
itself 
itself 
itself 
itself 
itself 
itself 
itself 
itself 


itself 











图 16 例 9 的 运行 输出 结果 








2 - Task 2 does nothing other than delete 





f 











itself, allowing execution to return to Task 1. 














1 - Task 1 runs and creates Task 2. 
Task 2 starts to run immediately as it 
has the higher priority. 


“Time tn S 









3 - Task 1 calls vTaskDelay(), allowing O 
the idle task to run until the delay time 
expires, and the whole sequence repeats. 
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图 17 例 9 执行 流程 
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1.10 调度 算法 — 简 述 


优先 级 抢占 式 调度 
本 章 的 示例 程序 已 经 演示 了 FreeRTOS 在 什么 时 候 以 及 以 什么 方式 选择 一 个 什么 
样 的 任务 来 执行 。 





。 每 个 任务 都 赋予 了 一 个 优先 级 。 
。 每 个 任务 都 可 以 存在 于 一 个 或 多 个 状态 。 


。 在 任何 时 候 都 只 有 一 个 任务 可 以 处 于 运行 状态 。 





。 调 度 器 总 是 在 所 有 处 于 就 绪 态 的 任务 中 选择 具有 最 高 优先 级 的 任务 来 执行 。 


这 种 类 型 的 调度 方案 被 称 为 "固定 优先 级 抢占 式 调 度 "。 所 谓 " 回 定 优先 级 "是 指 每 个 
任务 都 被 赋予 了 一 个 优先 级 ， 这 个 优先 级 不 能 被 内 核 本 身 改 变 (只 能 被 任务 修改 )。" 抢 占 
式 " 是 指 当 任务 进入 就 绪 态 或 是 优先 级 被 改变 时 ， 如 果 处 于 运行 态 的 任务 优先 级 更 低 ， 
则 该 任务 总 是 抢占 当前 运行 的 任务 。 

任务 可 以 在 阻塞 状态 等 待 一 个 事件 ， 当 事件 发 生 时 其 将 自动 回 到 就 绪 态 。 时 间 事 件 
发 生 在 某 个 特定 的 时 刻 ， 比 如 阻塞 超时 。 时 间 事 件 通 常用 于 周期 性 或 超时 行为 。 任 务 或 
中 断 服 务 例 程 往 队 列 发 送 消 息 或 发 送 任务 一 种 信号 量 , 都 将 触发 同步 事件 。 同步 事件 通 
常用 于 触发 同步 行为 ， 比 如 某 个 外 围 的 数据 到 达 了 。 

图 18 通过 图 示 茶 个 应 用 程序 的 执行 流程 展现 了 抢占 式 调度 的 行为 方式 。 












































Task 2 pre-empts Task 3 | | Task 1 pre-empts Task 2 


Task1 (high, event) | | N - : 
Task2 (med, periodic mmm | | — | ~ = 
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Task3 (low, event 


€ - T no 


1 t2/ t4 t5t6 t7 t8 .^ t9 t11 t13 
A ra t0 t12 


Task 2 pre-empts| Event processing is ` 




















Task 3 pre-empts the idle task. | 








the Idle task delayed until higher 
priority tasks block 














图 18 执行 流程 中 的 主要 抢占 点 
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如 图 18 中 所 示 : 
1. EWES 
空闲 任务 具有 最 低 优先 级 ， 所 以 每 当 有 更 高 优先 级 任务 处 于 就 绪 态 是 ， 空 闲 任 
务 就 会 被 抢占 一 一 如 图 中 t9, t5 A t9 时 刻 。 
2. 任务 3 


FreeRTOS 


Designed 





任务 3 是 一 个 事件 驱动 任务 。 其 工作 在 一 个 相对 较 低 的 优先 级 ， 但 优先 级 高 于 
空 闪 任务。 其 大 部 份 时 间 都 在 阻塞 态 等 待 其 关心 的 事件 。 每 当 事 件 发 生 时 其 就 
从 阻塞 态 转 移 到 就 绪 态 。 FreeRTOS 中 所 有 的 任务 间 通 信 机 制 (队列 , 信号 量 等 ) 
都 可 以 通过 这 种 方式 用 于 发 送 事件 以 及 让 任务 解除 阻塞 。 





zi 














FFE t3, t5 ARM t9 至 t12 之 间 的 茶 个 时 刻 发 生 。 发 生 在 t3 All t5 时 刻 的 事件 
可 以 立即 被 处 理 ， 因 为 这 些 时 刻 任务 3 在 所 有 可 运行 任务 中 优先 级 最 高 。 发 生 
在 t9 至 t12 之 间 茶 个 时 刻 的 事件 不 会 得 到 立即 处 理 ， 需 要 一 直 等 到 +12 时 刻 。 
因为 具有 更 高 优先 级 的 任务 1 和 任务 2 尚 在 运行 中 ， 只 有 到 了 t12 时 刻 ， 这 两 
个 任务 进入 阻塞 态 ， 使 得 任务 3 成 为 具有 最 高 优先 级 的 就 绪 态 任务 。 












































任务 2 

任务 2 是 一 个 周期 性 任务 ， 其 优先 级 高 于 任务 3 并 低 于 任务 1。 根 据 周期 间隔 ， 
任务 2 期 望 在 计 ，t6 和 t9 时刻 执行 。 

TE t6 时 刻 任 务 3 处 于 运行 态 , 但 是 任务 2 相对 具有 更 高 的 优先 级 ， 所 以 会 抢占 
任务 3， 并 立即 得 到 执行 。 任 务 2 完成 处 理 后 ， 在 t7 时 刻 返 回 阻塞 态 。 同 时 ， 
任务 3 得 以 重新 进入 运行 态 ， 继 续 完成 处 理 。 任 务 3 在 18 时 刻 进入 阻塞 状态 。 



































任务 1 





任务 1 也 是 一 个 事件 驱动 任务 。 任 务 1 在 所 有 任务 中 具有 最 高 优先 级 ， 因 此 可 
以 抢占 系统 中 的 任何 其 它 任务 。 在 图 中 看 到 ， 任 务 1 的 事件 只 是 发 生 在 在 t10 
时 刻 ， 此 时 任务 1 抢占 了 任务 2。 只 有 当 任 务 1 在 t11 时 刻 再 次 进入 阻塞 态 之 
后 ， 任 务 2 才 得 以 机 会 继续 完成 处 理 。 
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选择 任务 优先 级 

从 图 18 中 可 以 看 到 优先 级 分 配 是 如 何 从 根本 上 影响 应 用 程序 行为 的 。 

作为 一 种 通用 规则 , 完成 硬 实时 功能 的 任务 优先 级 会 高 于 完成 软件 时 功能 任务 的 优 
先 级 。 但 其 它 一 些 因 素 ， 比 如 执行 时 间 和 处 理 器 利用 率 ， 都 必须 纳入 考虑 范围 ， 以 保证 
应 用 程序 不 会 超过 硬 实时 的 需求 限制 。 

单调 速率 调度 (Rate Monotonic Scheduling, RMS) 是 一 种 常用 的 优先 级 分 配 技术 。 
其 根据 任务 周期 性 执行 的 速率 来 分 配 一 个 唯一 的 优先 级 。 具有 最 高 周期 执行 频率 的 任务 
赋予 高 最 优先 级 ; 具有 最 低 周 期 执行 频率 的 任务 赋予 最 低 优先 级 。 这 种 优先 级 分 配方 式 
被 证 明了 可 以 最 大 化 整个 应 用 程序 的 可 调度 性 (schedulability)， 但 是 运行 时 间 不 定 以 及 
并 非 所 有 任务 都 具有 周期 性 ， 会 使 得 对 这 种 方式 的 全 面 计算 变 得 相当 复杂 。 

































































协作 式 调度 

本 书 专注 于 抢占 式 调度 。FreeRTOS 可 以 选择 采用 协作 式 调度 。 

采用 一 个 纯粹 的 协作 式 调 度 器 , 只 可 能 在 运行 态 任务 进入 阻塞 态 或 是 运行 态 任务 显 
式 调用 taskYIELD() 时 ， 才 会 进行 上 下 文 切 换 。 任 务 永远 不 会 被 抢占 ， 而 具有 相同 优先 
级 的 任务 也 不 会 自动 共享 处 理 器 时 间 。 协作 式 调度 的 这 作 工 作 方式 虽然 比较 简单 , 但 可 
能 会 导致 系统 响应 不 够 快 。 

实现 混合 调度 方案 也 是 可 行 的 ， 这 需要 在 中 断 服 务 例 程 中 显 式 地 进行 上 下 文 切换 ， 
从 而 允许 同步 事件 产生 抢占 行为 ,但 时 间 事 件 却 不 行 。 这 样 做 的 结果 是 得 到 了 一 个 没有 
时 间 片 机 制 的 抢占 式 系统 。 或 许 这 正 是 所 期 户 的 ， 因 为 获得 了 效率 ， 并且 这 也 是 一 种 常 
用 的 调度 器 配置 。 
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2.1 概览 





基于 FreeRTOS HN HEU Hz 每 个 任务 都 是 具有 独立 权 
限 的 小 程序 。 这 些 独 立 的 任务 之 间 很 可 能 会 通过 相互 通信 以 提供 有 用 的 系统 功能 
FreeRTOS 中 所 有 的 通信 和 与 同步 机 制 都 是 基于 队列 实现 的 。 



































本 章 期 望 让 读者 了 解 以 下 事情 
。 如何 创建 一 个 队列 
。 队列 如 何 管 理 其 数据 
。 如何 向 队列 发 送 数据 
。 如何 从 队列 接收 数据 
。 队列 阻塞 是 什么 意思 
。 往 队列 发 送 和 从 队列 接收 时 ， 任 务 优先 级 会 有 什么 样 的 影响 


























本 章 仅 涵盖 任务 之 间 的 通信 。 任 务 与 中 断 之 间 的 通信 将 在 第 三 章 讲述 。 
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2.2 队列 的 特性 


数据 存储 

队列 可 以 保存 有 限 个 具有 确定 长 度 的 数据 单元 。 队 列 可 以 保存 的 最 大 单元 数目 被 称 
为 队列 的 "深度 "。 在 队列 创建 时 需要 设 定 其 深度 和 每 个 单元 的 大 小 。 

通常 情况 下 ， 队 列 被 作为 FIFO( 先 进 先 出 ) 使 用 ， 即 数据 由 队列 尾 写 入 ， 从 队列 首 读 
出 。 当 然 ， 由 队列 首 写 入 也 是 可 能 所 

往 队 列 写 入 数据 是 通过 池 节 拷贝 把 数据 复制 存储 到 队列 中 ; 从 队列 读 出 数据 使 得 把 
队列 中 的 数据 拷贝 删除 。 图 19 展现 了 队列 的 写 入 与 读 出 过 程 ， 以 及 读 写 操作 对 队列 中 
数据 的 影响 。 















































可 被 多 任务 存 取 
队列 是 具有 自己 独立 权限 的 内 核对 象 ， 并 不 属于 或 赋予 任何 任务 。 所 有 任务 都 可 以 
向 同一 队列 号 入 和 读 出 。 一 个 队列 由 多 方 写 入 是 经 常 的 事 , 但 由 多 方 读 出 倒是 很 少 遇 到 。 





























读 队 列 时 阻塞 

当 某 个 任务 试图 读 一 个 队列 时 ， 其 可 以 指定 一 个 阻塞 超时 时 间 。 在 这 段 时 间 中 ， 如 
果 队 列 为 空 ， 该 任务 将 保持 阻塞 状态 以 等 待 队 列 数据 有 效 。 当 其 它 任 务 或 中 断 服 务 例 程 
往 其 等 待 的 队列 中 写 入 了 数据 ， 该 任务 将 上 自动 由 阻塞 态 转移 为 就 绪 态 。 当 等 待 的 时 间 超 
过 了 指定 的 阻塞 时 间 , 即使 队列 中 尚 无 有 效 数据 , 任务 也 会 自动 从 阻塞 态 转移 为 就 绪 态 。 
由 于 队列 可 以 被 多 个 任务 读 取 ， 所 以 对 单个 队列 而 言 ， 也 可 能 有 多 个 任务 处 于 阻塞 
状态 以 等 等 队列 数据 有 效 。 这 种 情况 下 ,一 旦 队列 数据 有 效 ， 只 会 有 一 个 任务 会 被 解除 
阻塞 ， 这 个 任务 就 是 所 有 等 待 任务 中 优先 级 最 高 的 任务 。 而 如 果 所 有 等 竺 任务 的 优先 级 
相同 ， 那 么 被 解除 阻塞 的 任务 将 是 等 竺 最 久 的 任务 。 



































写 队列 时 阻塞 
同 读 队列 一 样 ， 任 务 也 可 以 在 写 队 列 时 指定 一 个 阻塞 超时 时 间 。 这 个 时 间 是 当 被 写 
队列 已 满 时 ， 任 务 进 入 阻塞 态 以 等 待 队列 空间 有 效 的 最 长 时 间 。 
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由 于 队列 可 以 被 多 个 任务 写 入 ， 所 以 对 单个 队列 而 言 ， 也 可 能 有 多 个 任务 处 于 阻塞 
状态 以 等 等 队列 空间 有 效 。 这 种 情况 下 ,， 一旦 队列 空间 有 效 ， 只 会 有 一 个 任务 会 被 解除 
阻塞 ， 这 个 任务 就 是 所 有 等 待 任务 中 优先 级 最 高 的 任务 。 而 如 果 所 有 等 竺 任务 的 优先 级 
相同 ， 那 么 被 解除 阻塞 的 任务 将 是 等 待 最 和 久 的 任务 。 




















创建 一 个 队列 用 于 任务 A 和 任务 B 之 间 通 信 . 此 队列 最 多 可 以 保存 5 个 整数 。 
当 队 列 团团 创建 时 ， 其 不 包含 任 何 数 据 单元 ， 所 以 是 空 的 。 











任务 B 已 经 读 走 了 一 个 数据 单元 ， 现 在 AZ KIAK 
数据 。 此 值 将 在 任务 B 下 一 次 诸 队 列 的 办 . 列 中 空 数据 单元 的 
个 数 变 为 四 个 。 





图 19 队列 读 写 过 程 示例 
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2.3 使 用 队列 


xQueueCreate() API 函数 

队列 在 使 用 前 必须 先 被 创建 。 

队列 由 声明 为 xQueueHandle 的 变量 进行 引用 。xQueueCreate() 用 于 创建 一 个 队 
列 ， 并 返回 一 个 xQueueHandle 句柄 以 便于 对 其 创建 的 队列 进行 引用 。 

当 创 建 队 列 时 ，FreeRTOS 从 堆 空 间 中 分 配 内 存 空间 。 分 配 的 空间 用 于 存储 队列 数 
据 结构 本 身 以 及 队列 中 包含 的 数据 单元 。 如 果 内 存 堆 中 没有 足够 的 空间 来 创建 队列 ， 
xQueueCreate() 将 返回 NULL。 第 五 章 会 有 关于 内 存 堆 管理 的 更 多 信息 。 













































































xQueueHandle xQueueCreate( unsigned portBASE TYPE uxQueueLength, 














unsigned portBASE TYPE uxItemSize ); 


程序 清单 29 xQueueCreate() API 函数 原型 


#27 xQueueCreate() 参 数 与 返回 值 





参数 名 描述 





uxQueueLength 队列 能 够 存储 的 最 大 单元 数目 ， 即 队列 深度 。 




















uxltemSize 队列 中 数据 单元 的 长 度 ， 以 字 节 为 单位 。 

返回 值 NULL 表示 没有 足够 的 堆 空 间 分 配给 队列 而 导致 创建 失败 。 
JE NULL 值 表 示 队 列 创 建成 功 。 此 返回 值 应 当 保存 下 来 ， 以 作为 
操作 此 队列 的 句柄 。 
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xQueueSendToBack() 5 xQueueSendToFront() API 函数 

如 同 函数 名 字面 意思 所 期 望 的 一 样 ，xQueueSendToBack() 用 于 将 数据 发 送 到 队列 
Æ; 而 xQueueSendToFront() 用 于 将 数据 发 送 到 队列 首 。 

xQueueSend() 完 全 等 同 于 xQueueSendToBack()。 

但 切记 不 要 在 中 断 服 务 例 程 中 调用 xQueueSendToFront() 或 
xQueueSendToBack()。 系 统 提供 中 断 安全 版 本 的 xQueueSendToFrontFromlSR() 与 
xQueueSendToBackFromlSR( 用 于 在 中 断 服 务 中 实现 相同 的 功能 。 这 些 将 在 第 三 章 中 
详 述 。 






































portBASE_TYPE xQueueSendToFront ( xQueueHandle xQueue, 


const void * pvItemToQueue, 





portTickType xTicksToWait ); 


程序 清单 30 The xQueueSendToFront() APIR URA 


portBASE_TYPE xQueueSendToBack ( xQueueHandle xQueue, 








const void * pvItemToQueue, 


portTickType xTicksToWait ); 


程序 清单 31 The xQueueSendToBack() API 函数 原型 


K 8 xQueueSendToFront() = xQueueSendToBack() 函 数 参 数 及 返回 值 





参数 名 描述 











xQueue 目标 队列 的 句柄 。 这 个 句柄 即 是 调用 xQueueCreate() £ iz BA 
列 时 的 返回 值 。 








pvltemToQueue 发 送 数 据 的 指针 。 其 指向 将 要 复制 到 目标 队列 中 的 数据 单元 。 





由 于 在 创建 队列 时 设置 了 队列 中 数据 单元 的 长 度 , 所 以 会 从 该 指 
针 指向 的 空间 复制 对 应 长 度 的 数据 到 队列 的 存储 区 域 。 














xTicksToWait 阻塞 超时 时 间 。 如 果 在 发 送 时 队列 已 满 ， 这 个 时 间 即 是 任务 处 于 
阻塞 态 等 待 队列 空间 有 效 的 最 长 等 待 时 间 。 
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返回 值 





FreeRTOS 


如 果 xTicksToWait t A 0. FAK 9j Ow, W 
xQueueSendToFront() Ej xQueueSendToBack() 均 会 立即 返回 。 


阻塞 时 间 是 以 系统 心跳 周期 为 单位 的 , 所 以 绝对 时 间 取 决 于 系统 
心跳 频率 。 常 量 portTICK_RATE_MS 可 以 用 来 把 心跳 时 间 单 位 
转换 为 毫秒 时 间 单 位 。 











如 果 把 xTicksToWait 设置 为 portMAX_DELAY, ， 并 且 在 
FreeRTOSConig.h 中 设 定 INCLUDE vTaskSuspend 为 1， 那 
么 阻塞 等 待 将 没有 超时 限制 。 








有 两 个 可 能 的 返回 值 : 








1. pdPASS 


返回 pdPASS 只 会 有 一 种 情况 ， 那 就 是 数据 被 成 功 发 送 到 队列 
中 。 





如 果 设 定 了 阻塞 超时 时 间 (xTicksToWait 非 0)， 在 函数 返回 之 前 
任务 将 被 转移 到 阻塞 态 以 等 待 队 列 空间 有 效 一 在 超时 到 来 前 能 
够 将 数据 成 功 写 入 到 队列 ， 函 数 则 会 返回 pdPASS。 





2. erQUEUE FULL 





如 果 由 于 队列 已 满 而 无 法 将 数据 写 入 ， 则 将 返回 
errQUEUE_FULL. 





如 果 设 定 了 阻塞 超时 时 间 CxTicksToWait 非 0)， 在 函数 返回 之 
前 任务 将 被 转移 到 阻塞 态 以 等 待 队列 空间 有 效 。 但 直到 超时 也 没 
有 其 它 任 务 或 是 中 断 服务 例 程 读 取 队 列 而 腾 出 空间 , 函数 则 会 返 
l=] errQUEUE FULL. 
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xQueueReceive() 5; xQueuePeek() API 函数 

xQueueReceive() 用 于 从 队列 中 接收 ( 读 取 ) 数据 单元 。 接 收 到 的 单元 同时 会 从 队列 
中 删除 。 

xQueuePeek() 也 是 从 从 队列 中 接收 数据 单元 ， 不 同 的 是 并 不 从 队列 中 删 出 接收 到 
的 单元 。xQueuePeek() 从 队列 首 接收 到 数据 后 ， 不 会 修改 队列 中 的 数据 ， 也 不 会 改变 
数据 在 队列 中 的 存储 序 顺 。 

切记 不 要 在 中 断 服务 例 程 中 调用 xQueueRceive() 和 xQueuePeek()。 中断 安全 版 本 
的 替代 API 函数 xQueueReceiveFromlSR() 将 会 在 第 三 章 中 讲述 。 











portBASE_TYPE xQueueReceive ( xQueueHandle xQueue, 





const void * pvBuffer, 


portTickType xTicksToWait ); 
图 20 xQueueReceive() API 函数 原型 
〈 译 者 注 - 怎 么 成 "图 20" 呢 ? 这 是 原文 中 的 Bug， 好 在 并 不 影响 什么 ) 














portBASE TYPE xQueuePeek(  xQueueHandle xQueue, 
const void * pvBuffer, 


portTickType xTicksToWait ); 


程序 清单 32 xQueuePeek() API 函数 原型 


#29 xQueueReceive() 与 XQueuePeek() 函 数 参数 与 返回 值 














参数 名 描述 
xQueue 被 读 队 列 的 句柄 。 这 个 句柄 即 是 调用 xQueueCreate() 创 建 该 队列 
时 的 返回 值 。 
pvBuffer 接收 缓存 指针 。 其 指向 一 段 内 存 区 域 ， 用 于 接收 从 队列 中 拷贝 来 
的 数据 。 





数据 单元 的 长 度 在 创建 队列 时 就 已 经 被 设 定 ， 所 以 该 指针 指向 的 
内 存 区 域 大 小 应 当 足 够 保存 一 个 数据 单元 。 


xTicksToWait 阻塞 超时 时 间 。 如 果 在 接收 时 队列 为 空 ， 则 这 个 时 间 是 任务 处 于 
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返回 值 





FreeRTOS 


阻塞 状态 以 等 待 队列 数据 有 效 的 最 长 等 待 时间 。 





如 果 xTicksToWait 设 为 0， 并 且 队 列 为 空 ， 则 xQueueRecieve() 
与 XQueuePeek() 均 会 立即 返回 。 


阻塞 时 间 是 以 系统 心跳 周期 为 单位 的 ， 所 以 绝对 时 间 取 决 于 系统 
心跳 频率 。 常 量 portTICK_RATE_MS 可 以 用 来 把 心跳 时 间 单 位 转 
换 为 毫秒 时 间 单 位 。 








如 果 把 xTicksToWait 设置 为 portMAX DELAY ， 并 且 在 
FreeRTOSConig.h 中 设 定 INCLUDE vTaskSuspend 为 1， 那么 
阻塞 等 待 将 没有 超时 限制 。 








有 两 个 可 能 的 返回 值 : 





1. pdPASS 





只 有 一 种 情况 会 返回 pdPASS， 那 就 是 成 功 地 从 队列 中 读 到 数据 。 


如 果 设 定 了 阻塞 超时 时 间 (xTicksToWait 非 0), 在 函数 返回 之 前 任 
务 将 被 转移 到 阻塞 态 以 等 等 队列 数据 有 效 一 在 超时 到 来 前 能 够 从 
队列 中 成 功 读 取 数据 ， 函 数 则 会 返回 pdPASS. 








2. errQUEUE FULL 


如 果 在 读 取 时 由 于 队列 已 空 而 没有 读 到 任何 数据 ， 则 将 返回 
errQUEUE FULL. 








如 果 设 定 了 阻塞 超时 时 间 CxTicksToWait 非 0)， 在 函数 返回 之 前 
任务 将 被 转移 到 阻塞 态 以 等 每 队列 数据 有 效 。 但 直到 超时 也 没有 
其 它 任 务 或 是 中 断 服 务 例 程 往 队 列 中 写 入 数据 ， 函 数 则 会 返回 
errQUEUE FULL. 
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uxQueueMessagesWaiting() API 函数 
uxQueueMessagesWaiting() 用 于 查询 队列 中 当前 有 效 数 据 单 元 个 数 。 
切记 不 要 在 中 断 服 务 例 程 中 调用 uxQueueMessagesWaiting()。 应 当 在 中 断 服 务 中 
使 用 其 中 断 安全 版 本 uxQueueMessagesWaitingFromISR(). 














unsigned portBASE TYPE uxQueueMessagesWaiting( xQueueHandle xQueue ); 


程序 清单 33 uxQueueMessagesWaiting() API 函数 原型 


K 10 uxQueueMessagesWaiting() 函 数 参 数 及 返回 值 

















参数 名 描述 
xQueue 被 查询 队列 的 句柄 。 这 个 句柄 即 是 调用 xQueueCreate() 创 建 该 队列 时 
的 返回 值 。 
返回 值 当前 队列 中 保存 的 数据 单元 个 数 。 返 回 0 表明 队列 为 空 。 





例 10. 读 队列 时 阻塞 

本 例 示 范 创 建 一 个 队列 ， 由 多 个 任务 往 队 列 中 写 数据 ， 以 及 从 队列 中 把 数据 读 出 。 
这 个 队列 创建 出 来 保存 long 型 数据 单元 。 往 队列 中 写 数据 的 任务 没有 设 定 阻塞 超时 时 
间 ， 而 读 队 列 的 任务 设 定 了 超时 时 间 。 

往 队 列 中 写 数 据 的 任务 的 优先 级 低 于 读 队 列 任务 的 优先 级 。 这 意味 着 队列 中 永远 不 
会 保持 超过 一 个 的 数据 单元 。 因 为 一 旦 有 数据 被 写 入 队列 ， 读 队列 任务 立即 解除 阻塞 ， 
抢占 写 队 列 任务 ， 并 从 队列 中 接收 数据 ， 同 时 数据 从 队列 中 删除 一 队列 再 一 次 变 为 空 队 
列 。 

程序 清单 34 展现 了 写 队 列 任务 的 代码 实现 。 这 个 任务 被 创建 了 两 个 实例 ， 一 个 不 
停 地 往 队 列 中 写 数值 100， 而 另 一 个 实例 不 停 地 往 队 列 中 写 入 数值 200。 任 务 的 入 口 参 
数 被 用 来 为 每 个 实例 传递 各 自 的 写 入 值 。 
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static void vSenderTask( void *pvParameters ) 
{ 

long lValueToSend; 

portBASE TYPE xStatus; 








/* 该 任务 会 被 创建 两 个 实例 , 所 以 写 入 队列 的 值 通过 任务 入 口 参数 传递 - 这 种 方式 使 得 每 个 实例 使 用 不 同 的 
值 。 队 列 创 建 时 指定 其 数据 单元 为 1ong 型 ， 所 以 把 入 口 参数 强制 转换 为 数据 单元 要 求 的 类 型 */ 


lValueToSend = ( long ) pvParameters; 




















/* 和 大 多 数 任务 一 样 ， 本 任务 也 处 于 一 个 死 循环 中 */ 
for( ;; ) 
{ 





/* 往 队列 发 送 数 据 
第 一 个 参数 是 要 写 入 的 队列 。 队 列 在 调度 器 启动 之 前 就 被 创建 了 ， 所 以 先 于 此 任务 执行 。 




















第 二 个 参数 是 被 发 送 数 据 的 地 址 ， 本 例 中 即 变量 lValueToseng 的 地 址 。 











第 三 个 参数 是 阻塞 超时 时 间 — 当 队 列 满 时 ， 任 务 转 入 阻塞 状态 以 等 待 队列 空间 有 效 。 本 例 中 没有 设 定 超 
时 时 间 ， 因 为 此 队列 决 不 会 保持 有 超过 一 个 数据 单元 的 机 会 ， 所 以 也 决 不 会 满 。 


xStatus = xQueueSendToBack( xQueue, &lValueToSend, 0 ); 


























if( xStatus !- pdPASS ) 
t 








/* 发 送 操作 由 于 队列 满 而 无 法 完成 - 这 必然 存在 错误 ， 因 为 本 例 中 的 队列 不 可 能 满 。 */ 
vPrintString( "Could not send to the queue.\r\n" ); 


























/* 人 允许 其 它 发 送 任务 执行 。 taskYIELD () 通知 调度 器 现在 就 切换 到 其 它 任务 ， 而 不 必 等 到 本 任务 的 时 
IATER */ 
taskYIELD(); 


程序 清单 34 DU 10 中 的 写 队列 任务 实现 代码 


程序 清单 35 展现 了 读 队 列 任务 的 代码 实现 。 读 队列 任务 设 定 了 100 毫秒 的 阻塞 超时 时 
间 ， 所 以 会 进入 阻塞 态 以 等 待 队 列 数据 有 效 。 一 旦 队列 中 数据 单元 有 效 ， 或 者 即使 队列 
数据 无 效 但 等 待 时 间 超 过 100 毫秒 ， 此 任务 将 会 解除 阻塞 。 在 本 例 中 ， 将 永远 不 会 出 
现 100 毫秒 超时 ， 因 为 有 两 个 任务 在 不 停 地 往 队 列 中 写 数 据 。 
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static void vReceiverTask( void *pvParameters ) 


{ 





/* 声明 变量 ， 用 于 保存 从 队列 中 接收 到 的 数据 。 */ 


long lReceivedValue; 








portBASE TYPE xStatus; 


const portTickType xTicksToWait - 100 / portTICK RATE MS; 


/* 本 任务 依然 处 于 死 循 环 中 。 */ 


for( ;; ) 


{ 


FreeRTOS 














/* 此 调用 会 发 现 队 列 一 直 为 空 ， 因 为 本 任务 将 立即 删除 刚 写 入 队列 的 数据 单元 。 */ 
if( uxQueueMessagesWaiting( xQueue ) != 0 ) 


{ 

















vPrintString( "Queue should have been empty!\r\n" ); 


/* 从 队列 中 接收 数据 
第 一 个 参数 是 被 读 取 的 队列 。 队 列 在 调度 器 启动 之 前 就 被 创建 了 ， 所 以 先 于 此 任务 执行 。 








第 二 个 参数 是 保存 接收 到 的 数据 的 缓冲 区 地 址 ， 本 例 中 即 变量 1ReceivedValue 的 地 址 。 此 变量 类 型 与 
队列 数据 单元 类 型 相同 ， 所 以 有 足够 的 大 小 来 存储 接收 到 的 数据 。 

















第 三 个 参数 是 阻塞 超时 时 间 - 当 队 列 空 时 ， 任 务 转 入 阻塞 状态 以 等 待 队列 数据 有 效 。 本 例 中 常量 
来 将 100 毫 秒 绝对 时 间 转 换 为 以 系统 心跳 为 单位 的 时 间 值 。 


pi 

















pase 


portTICK_RATE_MS 
ay 


xStatus = xQueueReceive( xQueue, &lReceivedValue, xTicksToWait ); 








if( xStatus == pdPASS ) 














{ 

/* 成 功 读 出 数据 ， 打 印 出 来 。 */ 

vPrintStringAndNumber( "Received = ", lReceivedValue ); 
} 
else 
{ 

/* 等 待 100ms 也 没有 收 到 任何 数据 。 

必然 存在 错误 ， 因 为 发 送 任务 在 不 停 地 往 队 列 中 写 入 数据 */ 

vPrintString( "Could not receive from the queue.\r\n" ); 
) 

程序 清单 35 例 10 中 的 读 队列 任务 实现 代码 
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程序 清单 36 包含 了 main() 函 数 的 实现 。 其 在 启动 调度 器 之 前 创建 了 一 个 队列 和 三 


ivan 
=l 
A 


个 任务 。 尽 
单元 ， 本 例 代码 还 是 创建 了 一 个 可 以 











/* 声明 一 个 类 型 为 xQueueHandle 的 变量 . 


xQueueHandle xQueue; 





int main( void ) 























对 任务 的 优先 级 的 设计 使 得 队列 实际 上 在 任何 时 候 都 不 可 能 多 于 一 个 数据 


保存 最 多 5 个 long 型 值 的 队列 。 


其 用 于 保存 队列 句柄 ， 以 便 三 个 任务 都 可 以 引用 此 队列 */ 






































{ 

/* 创建 的 队列 用 于 保存 最 多 5 个 值 ， 每 个 数据 单元 都 有 足够 的 空间 来 存储 一 个 Long 型 变量 */ 

xQueue = xQueueCreate( 5, sizeof( long ) ); 

if( xQueue != NULL ) 

{ 
/* 创建 两 个 写 队 列 任务 实例 ， 任 务 入 口 参数 用 于 传递 发 送 到 队列 的 值 。 所 以 一 个 实例 不 停 地 往 队 列 发 送 
100， 而 另 一 个 任务 实例 不 停 地 往 队 列 发 送 200。 两 个 任务 的 优先 级 都 设 为 1。 */ 
xTaskCreate( vSenderTask, "Sender1", 1000, ( void * ) 100, 1, NULL ); 
xTaskCreate( vSenderTask, "Sender2", 1000, ( void * ) 200, 1, NULL ); 
/* 创建 一 个 读 队列 任务 实例 。 其 优先 级 设 为 2， 高 于 写 任务 优先 级 */ 
xTaskCreate( vReceiverTask, "Receiver", 1000, NULL, 2, NULL ); 
/* 启动 调度 器 ， 任 务 开始 执行 */ 
vTaskStartScheduler () ; 

} 

else 

{ 
/* 队列 创建 失败 */ 

} 

/* 如 果 一 切 正常 ，main () 函数 不 应 该 会 执行 到 这 里 。 但 如 果 执 行 到 这 里 ， 很 可 能 是 内 存 堆 空间 不 足 导致 空闲 

任务 无 法 创建 。 第 五 昔 有 讲述 更 多 关于 内 存 管 理 方面 的 信息 */ 

for( ;; ); 

) 
程序 清单 36 5i 10 中 的 main() 函 数 实现 代码 


写 队列 任务 在 每 次 循环 中 都 调用 


taskYIELD() 。taskYIELD() 通 知 调度 器 立即 进行 任 


务 切换 ， 而 不 必 等 到 当前 任务 的 时 间 片 耗 尽 。 某 个 任务 调用 taskYIELD() 等 效 于 其 自愿 


放弃 运行 态 。 日 





日 于 本 例 中 两 个 写 队列 任务 具有 相同 的 任务 优先 级 ,所 以 一 旦 其 中 一 个 任 


务 调用 了 taskYIELD()， 另 一 个 任务 将 会 得 到 执行 一 调用 taskYIELD() 的 任务 转移 到 





就 绪 态 , 同时 另 一 个 任务 进入 运行 态 
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这 样 就 可 以 使 得 这 两 个 任务 轮 翻 地 往 队 列 发 送 数 
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据 。 从 图 21 中 可 以 看 到 例 10 的 输出 结果 。 


c C\WINDOWS\system32\cmd.exe - rtosdemo 


yow ow wow wow 


yow Ww ow Wow wow 


rj 











图 21 例 10 输出 结果 


图 22 展示 了 本 例 的 执行 流程 








1 - The Receiver task runs first because it has the 
highest priority. It attempts to read from the queue. The 
queue is empty so the Receiver enters the Blocked state 
to wait for data to become available. Once the Receiver 
is blocked Sender 2 can run. 


/ 








3 - The Receiver task empties the queue | 
then enters the Blocked state again, 
allowing Sender 2 to execute once more. 
Sender 2 immediately Yields to Sender 1. 


p 
























Receiver - 
Sender 2 
Sender 1 



































| tt / Time ~ ? 
j |/ 
2 - Sender two writes to the queue, N b 一 下 人 
causing the Receiver to exit the Blocked 4 - Sender 1 writes to the queue, causing |^ 
state. The Receiver has the highest the Receiver to exit the Blocked state and 
priority so pre-empts Sender 2. pre-empt Sender 1 - and so it goes on ........ 











图 22 例 10 中 代码 的 执行 流程 
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使 用 队列 传递 复合 数据 类 型 

一 个 任务 从 单个 队列 中 接收 来 自 多 个 发 送 源 的 数据 是 经 常 的 事 。 通 常 接收 方 收 到 数 
据 后 ， 需 要 知道 数据 的 来 源 ， 并 根据 数据 的 来 源 决定 下 一 步 如 何 处 理 。 一 个 简单 的 方式 
就 是 利用 队列 传递 结构 体 ， 结 构 体 成 员 中 就 包含 了 数据 信息 和 来 源 信息 。 图 23 对 这 一 
方案 进行 了 展现 。 


































typedef struct 

{ 

int iValue; 
int iMeaning; 


Controlle 
1 0 
| 





















图 23 结构 体 被 用 于 队列 传递 的 一 种 情形 
从 图 23 中 可 以 看 出 : 
创建 一 个 队列 用 于 保存 类 型 为 xData 的 结构 体 数据 单元 。 结 构 体 成 员 包括 了 一 个 数 
据 值 和 表示 数据 含义 的 编码 ， 两 者 合 为 一 个 消息 可 以 一 次 性 发 送 到 队列 。 
中 央 控 制 任务 用 于 完成 主要 的 系统 功能 。 其 必须 对 队列 中 传 来 的 输入 和 其 它 系 统 状 
态 的 改变 作出 响应 。 

* CAN 总 线 任务 用 于 封装 CAN 总 线 的 接口 功能 。 当 CAN 总 线 任务 收 到 并 解码 一 个 消 
息 后 ， 其 将 把 解码 后 的 消息 放 到 xData 结构 体 中 发 往 控 制 任务 。 结 构 体 的 iMeaning 
成 员 用 于 让 中 央 控 制 任务 知道 这 个 数据 是 用 来 干什么 的 一 从 图 中 的 描述 可 以 看 
出 ， 这 个 数据 表示 电机 速度 。 结 构 体 的 iValue 成 员 可 以 让 中 央 控 制 任 务 知道 电机 的 
实际 速度 值 。 
人 机 接口 (HM 任务 用 于 对 所 有 的 人 机 接口 功能 进行 封装 。 设备 操作 员 可 能 通过 各 种 
方式 进行 命令 输入 和 参数 查询 ， 人 机 接口 任务 需要 对 这 些 操作 进行 检测 并 解析 。 当 
接收 到 一 个 新 的 命令 后 , 人 机 接口 任务 通过 xData 结构 将 命令 发 送 到 中 央 控 制 任务 。 

结构 体 的 iMeaning 成 员 用 于 让 中 央 探 制 任务 知道 这 个 数据 是 用 来 干什么 的 一 从 

图 中 的 描述 可 以 看 出 ， 这 个 数据 表示 一 个 新 的 参数 设置 。 结 构 体 的 iValue 成 员 可 以 

让 中 央 控 制 任务 知道 具体 的 设置 值 。 
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例 11. 写 队列 时 阻塞 / 往 队 列 发 送 结构 体 

例 11 与 例 10 类 似 ， 只 是 写 队列 任务 与 读 队列 任务 的 优先 级 交换 了 ， 即 读 队 列 任 
务 的 优先 级 低 于 写 队 列 任务 的 优先 级 。 并 且 本 例 中 的 队列 用 于 在 任务 间 传 递 结构 体 数 
据 ， 而 非 简单 的 长 整 型 数据 。 

程序 清单 37 展示 了 例 11 中 要 用 到 的 结构 体 定义 。 











/* 定义 队列 传递 的 结构 类 型 。 */ 
typedef struct 
{ 
unsigned char ucValue; 
unsigned char ucSource; 


} xData; 


/* 声明 两 个 xData 类 型 的 变量 ， 通 过 队列 进行 传递 。 */ 
static const xData xStructsToSend[ 2 ] = 


{ 





{ 100, mainSENDER 1 }, /* Used by Senderl. */ 
{ 200, mainSENDER 2 } /* Used by Sender2. */ 


程序 清单 37 定义 队列 传递 的 数据 结构 ， 并 声明 此 类 型 的 两 个 变量 在 本 例 中 使 用 . 


在 例 10 中 读 队 列 任 务 具 有 最 高 优先 级 ， 所 以 队列 不 会 拥有 一 个 以 上 的 数据 单元 。 
这 是 因为 一 旦 数据 被 写 队列 任务 写 进 队列 , 读 队列 任务 立即 抢占 写 队 列 任务 , 把 刚 写 入 
的 数据 单元 读 走 。 在 例 11 中 ， 写 队列 任务 具有 最 高 优先 级 ， 所 以 队列 正常 情况 下 一 直 
是 处 于 满 状 态 。 这 是 因为 一 旦 读 队 列 任务 从 队列 中 读 走 一 个 数据 单元 ， 某 个 写 队 列 任务 
































就 会 立即 抢占 读 队列 任务 ,把 刚刚 读 走 的 位 置 重新 写 入 , 之 后 便 又 转 入 阻塞 态 以 等 待 队 
列 空 间 有 效 。 





程序 清单 38 是 写 队 列 任务 的 实现 代码 。 写 队列 任务 指定 了 100 毫秒 的 阻塞 超时 时 
间 ， 以 便 在 队列 满 时 转 入 阻塞 态 以 等 待 队列 空间 有 效 。 进 入 阻塞 态 后， 一 旦 队列 空间 有 
效 ， 或 是 等 竺 超过 了 100 渤 秒 队列 空间 尚 无 效 ， 其 将 解除 阻塞 。 在 本 例 中 ， 将 永远 不 
会 出 现 100 毫秒 超时 的 情况 ， 因 为 读 队 列 任务 在 不 停 地 从 队列 中 读 出 数据 从 而 腾 出 队 
列 数据 空间 。 
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static void vSenderTask( void *pvParameters ) 

{ 

portBASE_TYPE xStatus; 

const portTickType xTicksToWait = 100 / portTICK_RATE_MS; 


/* As per most tasks, this task is implemented within an infinite loop. 


for( ;; ) 
t 
/* Send to the queue. 


第 二 个 参数 是 将 要 发 送 的 数据 结构 地 址 。 这 个 地 址 是 从 任务 入 口 参数 中 传 入 ， 所 以 直接 使 用 


pvParameters. 








第 三 个 参数 是 阻塞 超时 时 间 — 当 队 列 满 时 ， 任 务 转 入 阻塞 态 等 待 队列 空间 有 效 的 最 长 时 间 。 指 定 超时 时 









































阻塞 态 ， 此 时 读 队 列 任务 才 会 得 以 执行 ， 才 能 从 队列 中 把 数据 读 走 。 */ 

xStatus = xQueueSendToBack( xQueue, pvParameters, xTicksToWait ); 
if( xStatus !- pdPASS ) 

{ 

/* 写 队列 任务 无 法 将 数据 写 入 队列 ， 直 至 100 毫 秒 超时 。 














间 是 因为 写 队列 任务 的 优先 级 高 于 读 任 务 的 优先 级 。 所 以 队列 如 预期 一 样 很 快 写 满 ， 写 队列 任务 就 会 转 入 


这 必然 存在 错误 ， 因 为 只 要 写 队 列 任务 进入 阻塞 态 ， 读 队列 任务 就 会 得 到 执行 ， 从 而 读 走 数据 ， 腾 


出 空间 */ 
vPrintString( "Could not send to the queuve.\r\n" ); 











/* 让 其 他 写 队列 任务 得 到 执行 。 */ 
taskYIELD(); 





程序 清单 38 例 11 中 写 队 列 任务 的 实现 代码 . 


读 队 列 任务 的 优先 级 最 低 , 所 以 只 有 在 所 有 写 队 列 任务 都 进入 阻塞 态 后 才 有 机 会 得 
到 执行 。 而 写 队 列 任务 只 会 在 队列 满 时 才 会 进入 阻塞 态 , 所 以 读 队列 任务 得 到 执行 时 队 


列 已 满 。 因 此 读 队列 任务 只 管 不 停 地 读 取 数据 ， 不 必 设 定 超时 时 间 。 
读 队 列 任务 的 实现 代码 参见 程序 列表 39. 
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static void vReceiverTask( void *pvParameters ) 


{ 
/* 


声明 











结构 体 变量 以 保存 从 队列 中 读 出 的 数据 单元 */ 


xData xReceivedStructure; 


portBASE TYPE xStatus; 


FreeRTOS 


/* This task is also defined within an infinite loop. */ 


for( ;; ) 


{ 





/* 读 队列 任务 的 优先 级 最 低 ， 所 以 其 只 可 能 在 写 队 列 任务 阻塞 时 得 到 执行 。 而 写 队 列 任务 只 会 在 队列 写 
满 时 才 会 进入 阻塞 态 ， 所 以 读 队列 任务 执行 时 队列 肯定 已 满 。 所 以 队列 中 数据 单元 的 个 数 应 当 等 于 队列 的 
深度 - 本 例 中 队列 深度 为 3 */ 

if( uxQueueMessagesWaiting( xQueue ) != 3) 


{ 




















vPrintString( "Queue should have been full!\r\n" ); 
} 
/* Receive from the queue. 


第 二 个 参数 是 存放 接收 数据 的 缓存 空间 。 本 例 简单 地 采用 一 个 具有 足够 空间 大 小 的 变量 的 地 址 。 









































为 读 队 列 任 会 只 会 在 队列 满 时 才 会 得 到 执行 ， 


> 











第 三 个 参数 是 阻塞 超时 时 间 - 本 例 不 需要 指定 超时 时 间 
故而 不 会 因 队 列 空 而 阻塞 */ 


xStatus = xQueueReceive( xQueue, &xReceivedStructure, 0 ); 

















if( xStatus -- pdPASS ) 























t 
/* 数据 成 功 读 出 ， 打 印 输出 数值 及 数据 来 源 。 */ 
if( xReceivedStructure.ucSource == mainSENDER 1 ) 
{ 
vPrintStringAndNumber ( "From Sender 1 =", xReceivedStructure.ucValue ) ; 
} 
else 
{ 
vPrintStringAndNumber ( "From Sender 2 =", xReceivedStructure.ucValue ) ; 
} 
} 
else 
{ 
/* 没有 读 到 任何 数据 。 这 一 定 是 发 生 了 错误 ， 因 为 此 任务 只 支 在 队列 满 时 才 会 得 到 执行 */ 
vPrintstring( "Could not receive from the queue.\r\n" ); 
} 
程序 清单 39 例 11 中 读 队列 任务 的 实现 代码 . 
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ERZ main() 与 上 一 例 比 起 来 只 作 了 微小 的 改动 。 创 建 的 队列 数 可 以 保存 三 个 
xData 类 型 的 数据 单元 ， 并 且 交 换 了 写 队 列 任务 与 读 队 列 任 务 的 优先 级 。 本 例 main() 
函数 实现 代码 参见 程序 清单 40。 


int main( void ) 

























































































{ 

/* 创建 队列 用 于 保存 最 多 3 个 xData 类 型 的 数据 单元 。 */ 

xQueue = xQueueCreate( 3, sizeof( xData ) ); 

if( xQueue != NULL ) 

{ 
/* 为 写 队 列 任务 创建 2 个 实例 。 The 
任务 入 口 参数 用 于 传递 发 送 到 队列 中 的 数据 。 因 此 其 中 一 个 任务 往 队 列 中 一 直 写 入 
xStructsToSend[0], ， 而 另 一 个 则 往 队 列 中 一 直 写 入 xStructsTosend[1] 。 这 两 个 任务 的 优先 级 都 
设 为 2， 高 于 读 队列 任务 的 优先 级 */ 
xTaskCreate( vSenderTask, "Sender1", 1000, &( xStructsToSend[ 0 ] ), 2, NULL ); 
xTaskCreate( vSenderTask, "Sender2", 1000, &( xStructsToSend[ 1 ] ), 2, NULL ); 
/* 创建 读 队 列 任务 。 
读 队列 任务 优先 级 设 为 1， 低 于 写 队 列 任务 的 优先 级 。 */ 
xTaskCreate( vReceiverTask, "Receiver", 1000, NULL, 1, NULL ); 
/* 局 动 调度 器 ， 创 建 的 任务 得 到 执行 。 */ 
vTaskStartScheduler(); 

) 

else 

{ 
/* 创建 队列 失败 。 */ 

} 

/* 如 果 一 切 正常 ，main () 函数 不 应 该 会 执行 到 这 里 。 但 如 果 执 行 到 这 里 ， 很 可 能 是 内 存 堆 空间 不 足 导致 空闲 

任务 无 法 创建 。 第 五 章 将 提供 更 多 关于 内 存 管理 方面 的 信息 */ 

for( ;; ); 

) 


程序 清单 40 例 11 的 main() 函 数 实现 代码 。 


和 例 10 类 似 ， 写 队列 任务 在 每 次 循环 中 都 主动 进行 任务 切换 ， 所 以 两 个 数据 会 被 
轮 翻 地 写 入 到 队列 中 。 图 24 展示 了 例 11 代码 运行 的 输出 结果 。 
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c\ C\WINDOWS\system32\cmd_exe - rtosdemo : 
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Sender 
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图 24 例 11 的 输出 结果 


图 25 表述 的 是 当 写 队列 任务 优先 级 高 于 读 队 列 任务 优先 级 时 , 各 任务 的 执行 顺序 。 
对 图 25 的 更 详细 解释 请 参见 表 12。 





Receiver 
Sender 2 
Sender 1 








t1 t2 t3 “te t7 t8 t9 » 
t5 


图 25 例 11 的 执行 流程 
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FreeRTOS 


Designed 





K 11 图 25 的 要 点 解释 





描述 


写 队列 任务 1 得 到 执行 ， 并 往 队 列 中 发 送 数据 . 

写 队列 任务 1 切换 到 写 队列 任务 2。 写 队列 任务 2 往 队 列 中 发 送 数据 。 

写 队列 任务 2 又 切 回 写 队 列 任务 1。 写 队列 任务 1 再 次 将 数据 号 入 队列 ， 导 和 致 
队列 满 。 

写 队列 任务 1 切换 到 写 队 列 任务 2. 

写 队列 任务 2 试图 往 队 列 中 写 入 数据 。 但 由 于 队列 已 满 ， 所 以 写 队列 任务 2 转 
入 阻塞 态 以 等 待 队列 空间 有 效 。 这 使 得 写 队 列 任务 1 再 次 得 到 执行 。 

写 队列 任务 1 试图 往 队 列 中 写 入 数据 。 但 由 于 队列 已 满 ， 所 以 写 队 列 任务 1 也 
转 入 阻塞 态 以 等 待 队列 空间 有 效 。 此 时 号 队列 任务 均 处 于 阻塞 态 ， 这 才 使 得 被 
赋予 最 低 优 先 级 的 读 队列 任务 得 以 执行 。 

读 队列 任务 从 队列 读 取 数 据 ， 并 把 读 出 的 数据 单元 从 队列 中 移出 。 一 旦 队列 空 
间 有 效 ， 写 队列 任务 2 立即 解除 阻塞 ， 并 且 因为 其 具有 更 高 优先 级 ， 所 以 抢占 
读 队列 任务 。 写 队列 任务 2 又 往 队列 中 写 入 数据 ， 填 充 到 刚刚 被 读 队 列 任 务 腾 
出 的 存储 空间 ,使 得 队列 再 一 次 变 满 , 写 队 列 发 送 完 数据 后 便 调 用 task YIELD(), 
但 写 队 列 任务 1 尚 还 处 理 阻 塞 态 ， 所 以 写 队 列 任 务 2 并 未 被 切换 出 去 ， 继 续 执 
行 。 

写 队 列 任 务 2 试图 往 队 列 中 写 入 数据 。 但 队列 已 满 ， 所 以 写 队 列 任务 2 TEACH 
塞 态 。 两 个 写 队 列 任务 再 一 次 同时 处 于 阻塞 态 ， 所 以 读 队列 任务 得 以 执行 。 
读 队列 任务 从 队列 读 取 数 据 ， 并 把 读 出 的 数据 单元 从 队列 中 移出 。 一 旦 队列 空 
间 有 效 ， 写 队列 任务 1 立即 解除 阻塞 ， 并 且 因为 其 具有 更 高 优先 级 ， 所 以 抢占 
读 队列 任务 。 写 队列 任务 1 又 往 队列 中 写 入 数据 ， 填 充 到 刚刚 被 读 队 列 任 务 腾 
出 的 存储 空间 ,使 得 队列 再 一 次 变 满 , 写 队 列 发 送 完 数据 后 便 调用 task YIELD(), 
但 写 队 列 任务 2 尚 还 处 理 阻塞 态 ， 所 以 写 队 列 任务 1 并 未 被 切换 出 去 ， 继 续 执 
行 。 写 队列 任务 1 试图 往 队 列 中 写 入 数据 。 但 队列 已 满 ， 所 以 写 队 列 任务 1 转 
入 阻塞 态 。 



















































































两 个 写 队 列 任务 再 一 次 同时 处 于 阻塞 态 ， 所 以 读 队列 任务 得 以 执行 。 
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2.4 工作 于 大 型 数据 单元 





如 果 队 列 存储 的 数据 单元 尺寸 较 大 , 那 最 好 是 利用 队列 来 传递 数据 的 指针 而 不 是 对 
数据 本 身 在 队列 上 一 字 节 一 学 节 地 拷贝 进 或 找 贝 出 ,传递 指针 无 论 是 在 处 理 速 度 上 还 是 
内 存 空间 利用 上 都 更 有 效 。 但 是 ， 当 你 利用 队列 传递 指针 时 ， 一 定 要 十 分 小 心地 做 到 以 
下 两 点 : 

1， 指 针 指 向 的 内 存 空间 的 所 有 权 必 须 明 确 

当 任 务 间 通过 指针 共享 内 存 时 ， 应 该 从 根本 上 保证 所 不 会 有 任意 两 个 任务 同时 

修改 共享 内 存 中 的 数据 ,或 是 以 其 它 行为 方式 使 得 共享 内 存 数据 无 效 或 产生 一 致 性 

问题 。 原则 上 , 共享 内 存在 其 指针 发 送 到 队列 之 前 , 其 内 容 只 允许 被 发 送 任务 访问 ; 

共享 内 存 指针 从 队列 中 被 读 出 之 后 ， 其 内 容 亦 只 允许 被 接收 任务 访问 。 























2. 指针 指向 的 内 存 空间 必须 有 效 
如 果 指 针 指 向 的 内 存 空间 是 动态 分 配 的， 只 应 该 有 一 个 任务 负责 对 其 进行 内 存 
释放 。 当 这 段 内 存 空间 被 释放 之 后 ， 就 不 应 该 有 任何 一 个 任务 再 访问 这 段 空间 。 


























切忌 用 指针 访问 任务 栈 上 分 配 的 空间 。 因 为 当 栈 帧 发 生 改 变 后 ， 栈 上 的 数据 将 不 再 
有 效 。 
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3.1 概览 


事件 
嵌入 式 实时 系统 需要 对 整个 系统 环境 产生 的 事件 作出 反应 。 举 个 例子 ， 以 太 网 外 围 

部 件 收 到 了 一 个 数据 包 ( 事 件 ), 需要 送 到 TCP/IP 协议 栈 进行 处 理 (反应 )。 更 复杂 的 系统 

需要 处 理 来 自 各 种 源头 产生 的 事件 ， 这 些 事件 对 处 理 时 间 和 响应 时 间 都 有 不 同 的 要 求 。 

在 各 种 情况 下 ， 都 需要 作出 合理 的 判断 ， 以 达到 最 佳 事件 处 理 的 实现 策略 : 

1， 事 件 如 何 被 检测 到 ? 通常 采用 中 断 方式 ， 但 是 事件 输入 也 可 以 通过 查询 获得 。 

2. 什么 时 候 采用 中 断 方式 ?》 中断 服 务 例 程 (ISR) 中 的 处 理 量 有 多 大 ? 以 及 ISR 外 的 任 
务 量 有 多 大 ? 通常 情况 下 ，ISR 应 当 越 短 越 好 。 

3. 事件 如 何 通知 到 主 程序 (这 里 指 非 ISR 程序 ， 而 非 main() 程 序 ) 代 码 ? 这 些 代码 要 如 
何 架构 才能 最 好 地 适应 异步 处 理 ? 
FreeRTOS 并 没有 为 设计 人 员 提 供 具 体 的 事件 处 理 策略 , 但 是 提供 了 一 些 特性 使 得 

设计 人 员 采 用 的 策略 可 以 得 到 实现 ， 而 实现 方式 不 仅 简单 ， 而 且 具 有 可 维护 性 。 
必须 说 明 的 是 ， 只 有 以 "FromlSR" 或 "FROM_ISR" 结 束 的 API 函数 或 宏 才 可 以 在 中 

断 服务 例 程 中 。 
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本 章 期 望 能 清晰 地 告诉 读者 以 下 事情 : 
。 哪 些 FreeRTOS 的 API 函数 可 以 在 中 断 服 务 例 程 中 使 用 。 
。 延 迟 中 断 方案 是 处 何 实现 的 。 
。 如 何 创建 和 使 用 二 值 信 号 量 以 及 计数 信和 号 
。 二 值 信号 量 和 计数 信号 量 之 间 的 区 别 。 
。 如 何 利 用 队 利 在 中 断 服务 例 程 中 把 数据 传 入 传 出 。 
e 一些 FreeRTOS 移植 中 采用 的 中 断 嵌 套 模型 。 
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3.2 延迟 中 断 处 理 


采用 二 值 信号 量 同步 

二 值 信号 量 可 以 在 某 个 特殊 的 中 断 发 生 时 ,让 任务 解除 阻塞 , 相当 于 让 任务 与 中 断 
同步 。 这 样 就 可 以 让 中 断 事件 处 理 量 大 的 工作 在 同步 任务 中 完成 ， 中 断 服务 例 程 (ISR) 
中 只 是 快速 处 理 少 部 份 工作 。 如 此 ， 中 断 处 理 可 以 说 是 被 ?推迟 (deferred)” 到 一 个 "处理 
(handlen" 任 务 。 

如 果 某 个 中 断 处 理 要 求 特 别 紧急 ， 其 延迟 处 理 任务 的 优先 级 可 以 设 为 最 高 ， 以 保证 
延迟 处 理 任 务 随时 都 抢占 系统 中 的 其 它 任务 。 这 样 ， 延 运 处 理 任 务 就 成 为 其 对 应 的 ISR 
退出 后 第 一 个 执行 的 任务 ， 在 时 间 上 紧 接 着 ISR 执行 ， 相 当 于 所 有 的 处 理 都 在 ISR 中 
完成 一 样 。 这 种 方案 在 图 26 中 展现 。 



























































3 - Because the handler N 
task has the highest 





2 - The ISR executes. The 
ISR implementation uses a 
semaphore to unblock the 
‘Handler Task’. 







priority the ISR returns 
directly to it, leaving Task‘ 
in the Ready state for now. 

















ISR i Ye /: [4-The Handler Task 
: : : blocks on the semaphore 
‘Handler | $ i i |towaitforthenextevent, 
Task | | — ^ |allowing the lower priority 
I dI | Task1 to run once again. 
Task1 € |o PP 
ü ÉB Mu 





interrupt occurs. 
图 26 ”中断 打 断 某 个 任务 ， 但 返回 到 另 一 个 任务 
延迟 处 理 任 务 对 一 个 信和 号 量 进行 带 阻 塞 性 质 的 ”take" 调 用 ， 意 思 是 进入 阻塞 态 以 等 
符 事 件 发 生 。 当 事件 发 生 后 ，ISR 对 同一 个 信号 量 进行 "give” 操 作 ， 使 得 延迟 处 理 任务 
解除 阻塞 ， 从 而 事件 在 延 公 处 理 任务 中 得 到 相应 的 处 理 。 
“获取 (Taking， 带 走 ， 按 通常 的 说 法 译 为 获取 )" 和 ”给 出 (Giving)" 信 号 量 从 概念 上 讲 ， 
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在 不 同 的 应 用 场合 有 不 同 的 含义 。 在 经 典 的 信号 量 术语 中 ， 获 取信 号 量 等 同 于 一 个 P() 
操作 ， 而 给 出 信号 量 等 同 于 一 个 V() 操 作 。 









































译 者 注 : P 源 自 荷 兰 语 Parsseren， 即 英语 的 Pass; V 源 自 荷兰 语 Verhoog， 即 英语 
的 Increment。P(S)V(S) 操 作 是 信号 量 的 两 个 原子 操作 ，S 为 信号 量 Semaphore， 相 
当 于 一 个 标志 ， 可 以 代表 一 个 资源 ， 一 个 事件 等 等 ,初始 值 视 应 用 场合 而 定 。P(S)/V(S) 
原子 操作 有 如 下 行为 : 
P(S): IF (S <= 0) THEN 将 本 线程 加 入 S 的 等 待 队列 

S=S-1 
VS): S=S+1 

IF (S > 0) THEN 唤醒 某 个 等 待 线程 



































在 这 种 中 断 同步 的 情形 下 ,信号 量 可 以 看 作 是 一 个 深度 为 1 的 队列 。 这 个 队列 由 于 
最 多 只 能 保存 一 个 数据 单元 ， 所 以 其 不 为 空 则 为 满 (所 谓 " 二 值 ”)。 延 迟 处 理 任务 调用 
xSemaphoreTake() 时 ， 等 效 于 带 阻 塞 时 间 地 读 取 队 列 ， 如 果 队 列 为 空 的 话 任务 则 进入 
阻塞 态 。 当 事件 发 生 后 ，ISR 简单 地 通过 调用 xSemaphoreGiveFromISR() 放 置 一 个 令 
牌 (信和 号 量 ) 到 队列 中 ， 使 得 队列 成 为 满 状 态 。 这 也 使 得 延迟 处 理 任务 切 出 阻塞 态 ， 并 移 
除 令 牌 ， 使 得 队列 再 次 成 为 空 。 当 任务 完成 处 理 后 ， 再 次 读 取 队列 ， 发 现 队 列 为 衬 
进入 阻塞 态 ， 等 待 下 一 次 事件 发 生 。 整 个 流程 在 图 27 中 有 所 展现 。 

如 图 27 所 示 ， 中 断 给 出 信号 量 ， 甚 至 是 在 信号 量 第 一 次 被 获取 之 前 就 给 出 ;而 任 
务 在 获取 信号 量 之 后 再 也 不 给 回来 。 这 就 是 为 什么 说 这 种 情况 与 读 写 队列 相似 。 这 也 经 
常会 给 大 家 造成 迷惑 , 因为 这 种 情形 和 其 它 信 号 量 的 使 用 场合 大 不 相同 。 在 其 它 场合 下 ， 
任务 获得 (Take) 了 信号 量 之 后 ， 必 须 得 给 (Give) 回 来 一 一 如 同 第 四 章 描述 一 样 。 
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vSemaphoreCreateBinary() API 函数 
FreeRTOS 中 各 种 信号 量 的 句柄 都 存储 在 xSemaphoreHandle 类 型 的 变量 中 。 
在 使 用 信号 量 之 前 ， 必 须 先 创建 它 。 创 建 二 值 信 号 量 使 用 
vSemaphoreCreateBinary()API 函数 



































Ri 











void vSemaphoreCreateBinary( xSemaphoreHandle xSemaphore ); 


程序 清单 41 vSemaphoreCreateBinary() API 函数 原型 


表 41 vSemaphoreCreateBinary() 参 数 





xSemaphore 创建 的 信号 量 


iu 














需要 说 明 的 是 vSemaphoreCreateBinary() 在 实现 上 是 一 个 宏 ， 所 以 
言 号 量变 量 应 当 直 接 传 入 ， 而 不 是 传 址 。 本 章 中 包含 本 函数 调用 的 示 
例 可 用 于 参考 进行 复制 。 
































“ 信号 量 API 实际 上 是 由 一 组 宏 实现 的 ， 而 不 是 函数 。 本 书 中 提 及 到 这 些 宏 的 地 方 都 简单 地 以 函数 
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Task 


| ] xSemaphoreTake() 


The semaphore is not 
available... 


SO the task is blocked 
waiting for the semaphore 








Task 







nterrupt! 
xSemaphoreGiveFromISR( 






) 


xSemaphoreTake() 


An interrupt occurs...that 
‘gives’ the semaphore.... 


ask 


nterrupt! 
xSemaphoreGiveFromISR() xSemaphoreTake() 





...Which unblocks the task 
(the semaphore is now 
available)... 


ask 


LLLI xSemaphoreTake() 
O 


...that now successfully 
‘takes’ the semaphore, so it 
is unavailable once more. 








ask 


imm] 


The task can now perform its action, when complete 
it will once again attempt to 'take' the semaphore 
which will cause it to re-enter the Blocked state. 








图 27 ”使 用 一 个 二 值 信号 量 实现 任务 与 中 断 同步 
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xSemaphoreTake() API 函数 


“TJE 




















(Taking)" 一 个 信和 号 量 意 为 "获取 (Obtain)? 或 "接收 (Receive)” 信 和 号 量 。 只 有 当 信 











iu 














号 量 有 效 的 时 候 才 可 以 被 获取 。 在 经 典 信号 量 术 中 , xSemaphoreTake() 5; [8] T-— PO 


除 互 斥 信号 量 (Recursive Semaphore， 直 译 为 递归 信和 号 量 ， 


斥 信号 量 ) 外 ， 





portBASE 














TYPE 








BRA 


xSemaphore 


xTicks ToWait 


FreeRTOS 




















fx 通常 rm 的 说 法 译 为 互 





所 有 类 型 的 信号 量 都 可 以 调用 函数 xSemaphoreTake() KIRA. 
但 xSemaphoreTake() 不 能 在 中 断 服务 例 程 中 调用 。 














xSemaphoreTake( xSemaphoreHandle xSemaphore, portTickType xTicksToWait ); 


程序 清单 42 xSemaphoreTake() API 函数 原型 


表 13 xSemaphoreTake() 参 数 及 返回 值 





描述 


获取 得 到 的 信号 量 


lm 
ium 








322 rp 


























用 前 必须 先 创建 。 


言 号 量 由 定义 为 xSemaphoreHandle 类 型 的 变量 引用 。 信和 号 量 在 使 

















阻塞 超时 时 间 。 任 务 进入 阻塞 态 以 等 待 信号 量 有 效 的 最 长 时 间 。 








立即 返回 。 


阻塞 时 间 是 以 系统 心跳 周期 为 单位 的 ， 所 以 纤 


t 








色 对 时 间 取 决 于 系统 心 





跳 频 率 。 常 量 portTICK_RATE_MS 可 以 用 来 把 心跳 时 间 单 位 转换 








为 毫秒 时 间 单 位 。 


如 果 把 xTicksToWait 设置 为 portMAX DELAY , 3f H Æ 
FreeRTOSConig.h Pixie INCLUDE vTaskSuspend 75 1. 那么 阻 


塞 等 待 将 没有 超时 限制 。 
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返回 值 有 两 个 可 能 的 返回 值 : 











1. pdPASS 





只 有 一 种 情况 会 返回 pdPASS， 那 就 是 成 功 获得 信号 量 。 


lm 
ium 








如 果 设 定 了 阻塞 超时 时 间 (xTicksToWait JE 0), 在 函数 返回 之 前 任务 
将 被 转移 到 阻塞 态 以 等 待 信号 量 有 效 。 如 果 在 超时 到 来 前 信号 量变 
为 有 效 ， 亦 可 被 成 功 获取 ， 返 回 pdPASS. 


lm 




















2. pdFALSE 





未 能 获得 信号 量 。 








如 果 设 定 了 阻塞 超时 时 间 (xTicksToWait 非 0)， 在 函数 返回 之 前 任 
务 将 被 转移 到 阻塞 态 以 等 竺 信号 量 有 效 。 但 直到 超时 信号 量 也 没有 
变 为 有 效 ， 所 以 不 会 获得 信号 量 ， 返 回 pdFALSE. 





























xSemaphoreGiveFromISR() API 函数 

除 互 斥 信 号 量 外 ，FreeRTOS 文 持 的 其 它 类 型 的 信号 量 都 可 以 通过 调用 
xSemaphoreGiveFromlSR()24 H1 . 

xSemaphoreGiveFromISR()Jé xSemaphoreGive() 的 特殊 形式 , 专门 用 于 中 断 服务 
例 程 中 。 




















portBASE TYPE xSemaphoreGiveFromISR( xSemaphoreHandle xSemaphore, 





portBASE TYPE *pxHigherPriorityTaskWoken ); 





程序 清单 43 xSemaphoreGiveFromISR() API 函数 原型 
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K 14 xSemaphoreGiveFromISR() 2 5j 3k PME 


参数 名 


xSemaphore 


pxHigherPriority TaskWoken 


返回 值 
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描述 























信和 号 量 由 定义 为 xSemaphoreHandle 类 型 的 变量 引用 。 
信号 量 在 使 用 前 必须 先 创建 。 
































对 某 个 信号 量 而 言 ， 可 能 有 不 止 一 个 任务 处 于 阻塞 态 在 
等 待 其 有 效 。 调 用 xSemaphoreGiveFromlSR() 会 让 信 
号 量变 为 有 效 ， 所 以 会 让 其 中 一 个 等 竺 任务 切 出 阻塞 
态 。 如 果 调 用 xSemaphoreGiveFromlSR() 使 得 一 个 任 
务 解除 阻塞, 并且 这 个 任务 的 优先 级 高 于 当前 任务 (也 就 
是 被 中 断 的 任务 )， 那 么 xSemaphoreGiveFromISR() 会 
在 函数 内 部 将 *pxHigherPriorityTaskWoken 设 为 
pdTRUE. 
































如 8t xSemaphoreGiveFromISR() 将 此 值 设 为 
pdTRUE， 则 在 中 断 退 出 前 应 当 进 行 一 次 上 下 文 切换 。 
这 样 才能 保证 中 断 直 接 返 回 到 就 绪 态 任务 中 优先 级 最 
高 的 任务 中 。 


有 两 个 可 能 的 返回 值 : 








1. pdPASS 
xSemaphoreGiveFromlSR() 调 用 成 功 。 


2. pdFAIL 





如 果 信 号 


li 


已 经 有 效 ， 无 法 给 出 ， 则 返回 pdFAIL. 
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例 12. 利用 二 值 信号 量 对 任务 和 中 断 进行 同步 
本 例 在 中 断 服务 例 程 中 使 用 一 个 二 值 信号 量 让 任务 从 阻塞 态 中 切换 出 来 一 一 从 效 





果 上 等 同 于 让 任务 与 中 断 进行 同步 。 
一 个 简单 的 周期 性 任务 用 于 每 隔 500 








毫秒 产生 一 个 软件 中 断 。 之 所 以 采用 软件 中 





断 ， 是 因为 在 模拟 的 DOS 环境 中 ， 很 难 挂 接 一 个 真正 的 IRQ 中 断 。 相 比 之 下 ， 使 用 软 
件 中 断 要 方便 得 多 。 程 序 清 单 44 即 是 这 个 周期 任务 的 实现 代码 。 需 要 说 明 的 是 ， 此 任 
务 在 产生 中 断 之 前 和 之 后 都 会 打印 输出 一 个 字符 串 。 这 样 就 可 以 在 最 终 的 执行 结果 中 直 











观 地 看 出 整个 程序 的 执行 流程 。 











static void vPeriodicTask( void *pvParameters ) 

















以 便 在 执行 结果 中 直观 直 出 执行 流程 * / 

















vPrintString( "Periodic task - About to generate an interrupt.\r\n" ); 





vPrintString( "Periodic task - Interrupt generated.\r\n\r\n\r\n" ); 


{ 
for( ;; ) 
{ 
/* 此 任务 通过 每 500 毫 秒 产生 一 个 软件 中 断 来 “模拟 “中 断 事 件 / 
vTaskDelay( 500 / portTICK RATE MS ); 
/* 产生 中 断 ， 并 在 产生 之 前 和 之 后 输出 信息 ， 
. asm( int 0x82 ) /* 这 条 语句 产生 中 断 */ 
} 
} 


程序 清单 44 B12 HT BE ERER TES SAS 





程序 清单 45 展现 的 是 延迟 处 理 任务 的 具体 实现 一 一 此 任务 通过 使 用 二 值 





r1 
H 





zi 
ja 
Jr 











软件 中 断 进 行 同步 。 这 个 任务 也 在 每 次 循环 中 打印 输出 一 个 信息 ,， 这样 做 的 目的 同样 是 
可 以 在 程序 的 执行 输出 结果 中 直观 地 看 出 任务 与 中 断 的 执行 流程 。 


static void vHandlerTask( void *pvParameters ) 














/* As per most tasks, this task is implemented within an infinite loop. */ 





/* 使 用 信号 量 等 待 一 个 事件 。 信 和 号 量 在 调度 器 局 动 之 前 ， 也 即 此 任务 执行 之 前 就 已 被 创建 。 任 务 被 无 











超 




















时 阻塞 ， 所 以 此 函数 调用 也 只 会 在 成 功 获取 信号 量 之 后 才 会 返回 。 此 处 也 没有 必要 检测 返回 值 */ 

















portMAX DELAY ); 








本 例 的 事件 处 理 只 是 简单 地 打印 输出 一 个 信息 * / 


vPrintString( "Handler task - Processing event.\r\n" ); 


程序 清单 45 Bill 12 中 延迟 处 理 任务 的 实现 代码 (此 任务 与 中 断 同步 ) 


{ 
for( ;; ) 
{ 
xSemaphoreTake( xBinarySemaphore, 
/* 程序 运行 到 这 里 时 ， 事 件 必然 已 经 发 生 。 
} 
} 
FreeRTOS 
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程序 清单 46 展现 的 是 中 断 服 务 例 程 ， 这 才 是 真正 的 中 断 处 理 程序 。 这 段 代 码 做 的 
事情 非常 少 ， 仅 仅 是 给 出 一 个 信号 量 ， 以 让 延迟 处 理 任 务 解 除 阻 塞 。 注 意 这 里 是 如 何 使 
用 参数 pxHigherPriorityTaskWoken 的 。 这 个 参数 在 调用 xSemaphoreGiveFromISR() 
前 被 设置 为 pdFALSE， 如 果 在 调用 完成 后 被 置 为 pdgTRUE， 则 需要 进行 一 次 上 下 文 切 
换 。 

本 例 中 断 服务 例 程 的 语法 , 以 及 用 于 上 下 文 切换 调用 的 宏 , 都 是 基于 Open Watcom 
DOS 平台 的 移植 ， 与 其 它 平台 的 移植 可 能 会 有 所 不 同 。 对 于 实际 使 用 的 平台 ， 请 参考 
对 应 移植 的 demo 应 用 示例 ， 以 找到 正确 的 语法 要 求 。 














































































































static void interrupt _ far vExampleInterruptHandler( void ) 
static portBASE TYPE xHigherPriorityTaskWoken; 
xHigherPriorityTaskWoken = pdFALSE; 


/* 'Give' the semaphore to unblock the task. */ 


xSemaphoreGiveFromISR( xBinarySemaphore, &xHigherPriorityTaskWoken ); 














if( xHigherPriorityTaskWoken == pdTRUE ) 
/* 给 出 信号 量 以 使 得 等 待 此 信号 量 的 任务 解除 阻塞 。 如 果 解 出 阻塞 的 任务 的 优先 级 高 于 当前 任务 的 优先 





























级 - 强制 进行 一 次 任务 切换 ， 以 确保 中 断 直接 返回 到 解 出 阻塞 的 任务 (优选 级 更 高 ) 。 























说 明 : 在 实际 使 用 中 ，ISR 中 强制 上 下 文 切 换 的 宏 依赖 于 具体 移植 。 此 处 调用 的 是 基于 open Wat com DOS 
移植 的 宏 。 其 它 平台 下 的 移植 可 能 有 不 同 的 语法 要 求 。 对 于 实际 使 用 的 平台 ， 请 参 如 数 对 应 移植 自 带 的 示 
例 程序 ， 以 决定 正确 的 语法 和 符号 。 

*/ 

portSWITCH CONTEXT () ; 





























程序 清单 46 例 12 中 软件 中 断 的 中 断 服务 例 程 











main() 函 数 很 简单 ,创建 二 值 信号 量 及 任务 ,安装 中 断 服 务 例 程 ， 然后 启动 调度 器 。 
具体 实现 参见 程序 清单 47。 
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int main( void ) 


{ 





/* 信号 量 在 使 用 前 都 必须 先 创建 。 本 例 中 创建 了 一 个 二 值 信号 量 */ 


vSemaphoreCreateBinary( xBinarySemaphore ); 





/* 安装 中 断 服 务 例 程 */ 


dos setvect( 0x82, vExampleInterruptHandler ); 


/* 检查 信号 量 是 否 成 功 创建 */ 


if ( 


{ 





xBinarySemaphore != NULL ) 














/* 创建 延迟 处 理 任务 。 此 任务 将 与 中 断 同步 。 延 迟 处 理 任 务 在 创建 时 使 用 了 一 个 较 高 的 优先 级 ， 以 保证 
中 断 退 出 后 会 被 立即 执行 。 在 本 例 中 ， 为 延迟 处 理 任务 赋予 优先 级 3 */ 
xTaskCreate( vHandlerTask, "Handler", 1000, NULL, 3, NULL ); 




















/* 创建 一 个 任务 用 于 周期 性 产生 软件 中 断 。 此 任务 的 优先 级 低 于 延迟 处 理 任务 。 每 当 延 迟 处 理 任务 切 出 
阻塞 态 ， 就 会 抢占 周期 任务 */ 
xTaskCreate( vPeriodicTask, "Periodic", 1000, NULL, 1, NULL ); 


























/* Start the scheduler so the created tasks start executing. */ 


vTaskStartScheduler () ; 














/* 如 果 一 切 正 常 ，main () 函数 不 会 执行 到 这 里 ， 因 为 调度 器 已 经 开始 运行 任务 。 但 如 果 程 序 运 行 到 了 这 里 ， 








很 可 


for 


例 


能 是 由 于 系统 内 存 不 足 而 无 法 创建 空闲 任务 。 第 五 章 会 提供 更 多 关于 内 存 管理 的 信息 */ 
Cae) 

















程序 清单 47 例 12 中 的 main() 函 数 实现 代码 








12 的 输出 结果 参见 图 28。 和 期 望 的 一 样 , 延迟 处 理 任务 在 中 断 产 生 后 立即 执行 。 


所 以 延迟 处 理 任务 的 输出 信息 将 周期 任务 的 两 条 输出 信息 分 开 。 图 29 对 执行 流程 作出 
了 进一步 的 解释 。 
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c^ C\WINDOWS\system32\cmd.exe - rtosdemo E 


Handler task — Processing event. 
Periodic task — Interrupt generated. 


Perodic task — About to generate an interrupt. 
Handler task — Processing event. 
Periodic task — Interrupt generated. 


Perodic task — About to generate an interrupt. 
Handler task — Processing event. 
Periodic task — Interrupt generated. 


Perodic task — About to generate an interrupt. 
Handler task — Processing event. 
Periodic task 一 Interrupt generated. 


Perodic task — About to generate an interrupt. 
Handler task — Processing event. 
Periodic task — Interrupt generated. 








图 28 例 12 代码 执行 的 输出 结果 























3 - The interrupt 'gives' the semaphore, causing the Handlertaskto | 
2 - The Periodic task prints its first . unblock. The interrupt service routine then returns directly to the Handler 
message then forces an interrupt. The task because the Handler task is the highest priority Ready state task. 
interrupt service routine executes The handler task prints out its message before returning to the Blocked 
immediately. state to wait for the next interrupt. 
Interrupt 





Handler 
Periodic 


Ide " 
| t QN Time > 














1 - The Idle task is running most of the A 1 

lime. Every 500ms its gets pre-empted 4 - The Periodic task is once again the highest priority task - it prints [\ 

by the Periodic task. oul ils second message before entering the Blocked state again lo wail 
for the next time period. This leaves just the Idle task able to run. 








图 29 例 12 中 代码 的 执行 流程 
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例 12 演示 了 一 个 二 值 信 号 量 被 用 于 让 任务 和 中 断 进 行 同 步 。 整 个 执行 流程 可 以 描 
述 为 : 
1. 中 断 产生。 
2 中断 服务 例 程 局 动 ， 给 出 信号 量 以 使 延迟 处 理 任 务 解除 阻塞 。 
3. 当中 断 服务 例 程 退出 时 ， 延 迟 处 理 任 务 得 到 执行 。 延 迟 处 理 任 务 做 的 第 一 件 事 便 是 
获取 信号 量 。 
4. 延迟 处 理 任务 完成 中 断 事 件 处 理 后 , 试图 再 次 获取 信和 号 量 
任务 将 切入 阻塞 待 等 待 事件 发 生 。 




































































如 果 此 时 信和 号 量 无 效 ， 























在 中 断 以 相对 较 慢 的 频率 发 生 的 情况 下 ， 上 面 描述 的 流程 是 足够 而 完美 的 。 如 果 在 
延迟 处 理 任务 完成 上 一 个 中 断 事 件 的 处 理 之 前 ,新 的 中 断 事件 又 发 生 了 ， 等 效 于 将 新 的 
事件 锁 存 在 二 值 信 号 量 中 , 使 得 延迟 处 理 任 务 在 处 理 完 上 一 个 事件 之 后 ,立即 就 可 以 处 
理 新 的 事件 。 也 就 是 说 , 延迟 处 理 任 务 在 两 次 事件 处 理 之 间 , 不 会 有 进入 阻塞 态 的 机 会 ， 
因为 信号 量 中 锁 存 有 一 个 事件 ， 所 以 当 xSempaphoreTake() 调 用 时 ， 信 和 号 量 立 即 有 效 。 
这 种 情形 将 在 图 30 中 进行 展现 。 

在 图 30 中 可 以 看 到 ， 一 个 二 值 信号 量 最 多 只 可 以 锁 存 一 个 中 断 事件 。 在 锁 存 的 事 
件 还 未 被 处 理 之 前 ， 如 果 还 有 中 断 事 件 发 生 ， 那 么 后 续 发 生 的 中 断 事件 将 会 丢失 。 如 果 
用 计数 信号 量 代替 二 值 信 号 量 ， 那 么 ， 这 种 丢 中 断 的 情形 将 可 以 避免 。 
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就 如 同 我 们 可 以 把 二 值 信号 量 看 作 是 只 有 一 个 数据 单元 的 队列 一 样 , 计数 信号 量 可 
以 看 作 是 深度 大 于 1 的 队列 。 任 务 其 实 对 队列 中 存储 的 具体 数据 并 不 感 兴 其 只 关 





心 队列 是 空 还 是 非 空 。 
计数 信号 量 每 次 被 给 出 (Givem)， 其 队列 中 的 另 一 个 空间 将 会 被 使 用 。 队 列 中 的 有 
效 数 据 单元 个 数 就 是 信号 量 的 ?计数 (Count)" 值 。 
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Task 


| | | xSemaphoreTake() 


The semaphore is not 


available... 
..S0 the task is blocked 


waiting for the semaphore 


Task 


nterrupt! 
xSemaphoreGiveFromISR() xSemaphoreTake 


An interrupt occurs...that 
‘gives’ the semaphore... 


ask 


Interrupt! 
xSemaphoreGiveFromISR() xSemaphoreTake() 


...Which unblocks the task 
(the semaphore is now 
available) 





ask 


xSemaphoreTake() 


...that now successfully 
'takes' the semaphore, so it 
is unavailable once more. 





Interrupt! 
xSemaphoreGiveFromISR() 





Another interrupt occurs while the task is still — 
processing the first event. The ISR 'gives' The task is still processing 
the semaphore again, effectively latching the the first event. 

event so the event is not lost. 





ask 


xSemaphoreTake() 


When processing of the original event completes the task calls xSemaphoreTake() 
again. Because another interrupt has already occurred the semaphore is already 
available so the task takes the semaphore without ever entering the Blocked state. 





30 一 个 二 值 信号 量 最 多 只 能 锁 存 一 个 中 断 事件 
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he semaphore count is 0 


| L LL] xSemaphoreTake() 


The task is blocked waiting 
for a semaphore 











Task 






[The semaphore count is 1] 







Interrupt! 
xSemaphoreGiveFromISR( 





) 


xSemaphoreTake() 





An interrupt occurs...that 
‘gives’ the semaphore... 


















ask 






Interrupt! [The semaphore count is 1] 


xSemaphoreGiveFromISR( 





) xSemaphoreTake() 


„which unblocks the task 
(the semaphore is now 
available) 








[The semaphore count is 0] x 


| | L1 Lo xSemaphoreTake() 





..that now successfully 
'takes' the semaphore, so it 
is unavailable once more. 


fterrupt! [The semaphore count is 2] (749 


xSemaphoreGiveFromlSR() 


O 
Another two interrupts occurs while the task — : 
is still processing the first event. The ISR The task is still processing 
‘gives’ the semaphore each time, effectively the first event. 
latching both events so neither event is lost. 


ask 


[The semaphore count is 1] N 


xSemaphoreTake() 


When processing of the original event completes the task calls xSemaphoreTake() 
again. Another two semaphores are already ‘available’, one is taken without the task 
ever entering the Blocked state, leaving one more ‘latched’ semaphore available. 


图 31 使 用 计数 信号 量 对 事件 “计数 (Count)” 
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计数 信号 量 


1. 事件 计数 











号 量 有 以 下 两 种 典型 用 法 


量 在 每 次 被 给 出 时 其 计数 值 加 1。 


信号 量 在 





在 这 种 用 法 中 ， 每 次 事件 发 生 时 ， 中 断 服 务 例 程 者 

















Wi 





信和 号 


的 数目 与 已 处 理 

















用 于 事件 计数 的 计数 信号 




















2. 资源 管理 








在 这 种 用 法 中 ,信号 量 的 


控制 权 ， 其 必须 先 获得 信 
有 可 用 资源 。 当 任务 利用 资源 完成 工作 后 , 将 给 出 (归还 ) 信 





加 1。 


事件 的 数目 之 间 的 差 值 。 














里 ， 


| imi [n 


Ex Li 








HYD 





tat 


























延迟 处 理 














计数 值 用 于 表示 可 用 资源 的 数目 
的 计数 值 减 1。 








使 信号 量 











LX. p EX 














用 于 资源 
量 来 管理 资源 。 


管理 的 信号 量 









































了 使 用 信和 号 上 





xSemaphoreCreateCounting() API 函数 
FreeRTOS 中 所 有 种 类 的 信 


保存 。 

















FreeRTOS 





信号 量 


建 一 个 计数 信号 量 。 





程序 清单 48 xSemaphoreCreateCounting() API 函数 原型 
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任务 每 处 理 














Li EX 








IL MEHR ER Take 


号 量 在 每 次 被 获取 时 其 计数 值 减 1。 信 和 号 量 的 计数 值 其 实 就 是 已 发 生 事件 
这 种 机 制 可 以 参考 图 31。 
在 被 创建 时 其 计数 值 被 初始 化 为 0。 


。 一 个 任务 要 获取 资源 的 
当 计 数值 减 至 0， 则 表示 没 


的 计数 值 








AJE 








Wl 








， 在 创建 时 其 计数 值 被 初始 化 为 可 用 资源 总 数 。 第 四 章 


日 声明 为 xSemaphoreHandle 2 


涵 


在 使 用 前 必须 先 被 创建 。 使 用 xSemaphoreCreateCounting() API 函数 来 创 


xSemaphoreHandle xSemaphoreCreateCounting( unsigned portBASE TYPE uxMaxCount 
unsigned portBASE TYPE uxInitialCount ) 


EB? 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 
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#215 xSemaphoreCreateCounting() 2t Sik EHME 


参数 名 描述 


uxMaxCount 最 大 计数 值 。 如 果 把 计数 信号 量 类 比 于 队列 的 话 ，uxMaxCount 值 
就 是 队列 的 最 大 深度 。 

















当 此 信号 量 用 于 对 事件 计数 或 锁 存 事件 的 话 ，uxMaxCount 就 是 可 
锁 存 事件 的 最 大 数目 。 





























i5, uxMaxCount 应 


me 
MH 





当 此 信号 量 用 于 对 一 组 资源 的 访问 进行 
当 设 置 为 所 有 可 用 资源 的 总 数 。 














n 
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初始 计数 值 。 
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四 
qu 


uxInitialCount 








量 用 于 事件 计数 的 话 ，uxlnitialCount 应 当 设置 为 0 一 一 因 
被 创建 时 ， 还 没有 事件 发 生 。 
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当 此 信号 量 用 于 资源 管理 的 话 ，uxInitialCount 应 当 等 于 
uxMaxCount 一 一 因为 当 信号 量 被 创建 时 ， 所 有 的 资源 都 是 可 用 的 。 



































返回 值 如 果 返 回 NULL 值 , 表示 堆 上 内 存 空间 不 足 ， 所 以 FreeRTOS 无 法 
为 信号 量 结 构 分 配 内 存 导致 信号 量 创 建 失败 。 第 五 草 有 提供 更 多 的 
管理 方面 的 信息 。 






























































如 果 返 回 非 NULL 值 ， 则 表示 信和 号 量 创建 成 功 。 此 值 应 当 被 保存 起 
来 作为 这 个 的 信号 量 的 句柄 。 
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例 13. 利用 计数 信号 量 对 任务 和 中 断 进 行 同 步 

例 13 用 计数 信号 量 代替 二 值 信号 量 对 例 12 的 实现 进行 了 改进 。 修 改 main() 函 数 
调用 xSemaphoreCreateCounting()， 以 代替 对 xSemaphoreCreateBinary() I] Ui] H] «. 8 
的 API 调用 如 程序 清单 49 Bron: 


























/* 在 信号 量 使 用 之 前 必须 先 创建 。 本 例 中 创建 了 一 个 计数 信号 量 。 此 信号 量 的 最 大 计数 值 为 10， 初 始 计数 值 为 0 */ 











xCountingSemaphore = xSemaphoreCreateCounting( 10, 0 ); 


程序 清单 49 使 用 xSemaphoreCreateCounting() 创建 一 个 计数 信号 量 





为 了 模拟 多 个 事件 以 高 频率 发 生 ， 修 改 了 中 断 服 务 例 程 ， 在 每 次 中 断 多 次 "给 出 
(Give)" 信 号 量 。 每 个 事件 都 锁 存 到 信和 号 量 的 计数 值 中 。 修改 后 的 中 断 服务 例 程 如 程序 清 
单 50 所 示 。 














static void interrupt _ far vExampleInterruptHandler( void ) 


{ 


static portBASE TYPE xHigherPriorityTaskWoken; 
xHigherPriorityTaskWoken = pdFALSE; 








/* 多 次 给 出 信号 量 。 第 一 次 给 出 时 使 得 延迟 处 理 任务 解除 阻塞 。 后 续 给 出 用 于 演示 利用 被 信号 量 锁 存 事件 ， 
以 便 延 迟 处 理 任何 依 序 对 这 些 中 断 事件 进行 处 理 而 不 会 和 中 断 。 用 这 种 方式 来 模拟 处 理 器 产生 多 个 中 断 ， 尽 管 
这 些 事件 只 是 在 单 次 中 断 中 模拟 出 来 的 */ 


xSemaphoreGiveFromISR( xCountingSemaphore, &xHigherPriorityTaskWoken ); 























m 











xSemaphoreGiveFromISR( xCountingSemaphore, &xHigherPriorityTaskWoken ); 


xSemaphoreGiveFromISR( xCountingSemaphore, &xHigherPriorityTaskWoken ); 


if( xHigherPriorityTaskWoken == pdTRUE ) 

























































































{ 
/* 给 出 信号 量 以 使 得 等 待 此 信和 号 量 的 任务 解除 阻塞 。 如 果 解 出 阻塞 的 任务 的 优先 级 高 于 当前 任务 的 优先 
级 - 强制 进行 一 次 任务 切换 ， 以 确保 中 断 直接 返回 到 解 出 阻塞 的 任务 (优选 级 更 高 ) 。 
说 明 : 在 实际 使 用 中 ，ISR 中 强制 上 下 文 切换 的 宏 依 赖 于 具体 移植 。 此 处 调用 的 是 基于 open Watcom Dos 
移植 的 宏 。 其 它 平 台 下 的 移植 可 能 有 不 同 的 语法 要 求 。 对 于 实际 使 用 的 平台 ， 请 参 如 数 对 应 移植 自 带 的 示 
例 程序 ， 以 决定 正确 的 语法 和 符号 。 
*/ 
portSWITCH CONTEXT 0; 
} 
} 
程序 清单 50 例 13 中 的 中 断 服 务 例 程 实现 代码 
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其 它 函 数 都 复 用 例 12 中 的 代码 ， 保 持 不 变 。 




















图 32 展示 了 例 13 的 输出 结果 。 从 图 中 可 以 看 到 ， 每 次 中 断 发 生 后 ， 延 迟 处 理 任 





























务 处 理 了 中 断 生 成 的 全 部 三 个 事件 [模拟 出 来 的 ]。 这 些 事件 被 锁 存 到 信和 号 量 的 计数 值 中 ， 
以 使 得 延迟 处 理 任务 可 以 对 它们 依 序 进行 处 理 。 












































T 


Handler task — Processing event. 
Handler task — Processi event. 
Handler task — Processi event. 
Periodic task — Interrupt generated. 


Perodic task — About to generate an interrupt. 
Handler task — Processing event. 

Handler task — Processing event. 

Handler task — Processing event. 

Periodic task 一 Interrupt generated. 


Perodic task — About to generate an interrupt. 
Handler task — Processing event. 

Handler task — Processing event. 

Handler task — Processing event. 

Periodic task — Interrupt generated. 


Perodic task 一 About to generate an interrupt. 
Handler task — Processing event. 
Handler task — Processing event. 
Handler task Processing event. 





图 32 413 的 输出 结果 
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3.4 在 中 断 服务 例 程 中 使 用 队列 


xQueueSendToFrontFromISR(), xQueueSendToBackFromISR() 5E xQueueReceiveFromISR() 
分 别 是 xQueueSendToFront(), xQueueSendToBack()!3 xQueueReceive() Itt] F Wr zz 4 
版 本 ， 专 门 用 于 中 断 服务 例 程 中 。 
信号 量 用 于 事件 通信 。 而 队列 不 仅 可 以 用 于 事件 通信 ， 还 可 以 用 来 传递 数据 。 




















xQueueSendToFrontFromISR() E xQueueSendToBackFromISR() API 函数 
xQueueSendFromlSR() 完 全 等 同 于 xQueueSendToBackFromISR(). 


portBASE TYPE xQueueSendToFrontFromISR( xQueueHandle xQueue, 
void *pvItemToQueue 
portBASE TYPE *pxHigherPriorityTaskWoken ); 
程序 清单 51 xQueueSendToFrontFromISR() API 函数 原型 


portBASE TYPE xQueueSendToBackFromISR( xQueueHandle xQueue, 
void *pvItemToQueue 


portBASE TYPE *pxHigherPriorityTaskWoken 


程序 清单 52 xQueueSendToBackFromISR() API 函数 原型 


K 16 xQueueSendToFrontFromISR 与 xXQueueSendToBackFromlSR() 参 数 与 返回 值 























参数 名 描述 
xQueue 目标 队列 的 句柄 。 这 个 句柄 即 是 调用 xQueueCreate() 
创建 该 队列 时 的 返回 值 。 
pvltemToQueue 发 送 数据 的 指针 。 其 指向 将 要 复制 到 目标 队列 中 的 数据 
单元 。 





由 于 在 创建 队列 时 设置 了 队列 中 数据 单元 的 长 度 ， 所 以 
会 从 该 指针 指向 的 空间 复制 对 应 长 度 的 数据 到 队列 的 
存储 区 域 。 
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pxHigherPriority TaskWoken 


返回 值 





有 效 使 用 队列 





对 某 个 队列 而 言 ， 可 能 有 不 止 一 个 任务 处 于 阻塞 态 在 等 
待 其 数据 有 效 。 调 用 xQueueSendToFrontFromISR() 
或 xQueueSendToBackFromlSR() 会 使 得 队列 数据 变 
为 有 效 ， 所 以 会 让 其 中 一 个 等 待 任务 切 出 阻塞 态 。 如 果 
调用 这 两 个 API 函数 使 得 一 个 任务 解除 阻塞 , 并 且 这 个 
任务 的 优先 级 高 于 当前 任务 (也 就 是 被 中 断 的 任务 )， 那 
么 API 会 在 函数 内 部 将 pxHigherPriorityTaskWoken i 
为 pdTRUE. 




















如 果 这 两 个 API 函数 将 此 值 设 为 pdTRUE, 则 在 中 断 退 
出 前 应 当 进 行 一 次 上 下 文 切换 。 这 样 才能 保证 中 断 直 接 
返回 到 就 绪 态 任务 中 优先 级 最 高 的 任务 中 。 


有 两 个 可 能 的 返回 值 : 








1. pdPASS 


返回 pdPASS 只 会 有 一 种 情况 , 那 就 是 数据 被 成 功 发 送 
到 队列 中 。 





2. errQUEUE FULL 





如 果 由 于 队列 已 满 而 无 法 将 数据 写 入 ， 则 将 返回 
errQUEUE FULL. 





FreeRTOS 的 大 多 数 demo 应 用 程序 中 都 包含 一 个 简单 的 UART 驱动 ， 其 通过 队 
列 将 字符 传递 到 发 送 中 断 例 程 ， 也 使 用 队列 将 字符 从 接收 中 断 例 程 中 传递 出 来 。 发 送 或 
接收 的 每 个 字符 都 通过 队列 单独 传递 。 这 些 UART 驱动 的 这 种 实现 方式 只 是 单纯 了 为 
了 演示 如 何在 中 断 中 使 用 队列 。 实际 上 利用 队列 传递 单个 字符 是 极其 低 效 的 , 特别 是 在 
波 特 率 较 高 的 时 后 ， 所 以 这 种 方式 并 不 建议 用 在 产品 代码 中 。 实际 应 用 中 可 以 采用 下 述 
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更 有 效 的 方式 : 





。 将 接收 到 的 字符 先 缓存 到 内 存 中 。 
Wi Ja 














使 用 信号 量 让 某 个 任务 解除 阻塞 ， 这 个 任务 将 对 字符 缓存 进行 处 理 。 











当 接 收 到 一 个 传输 完成 消息 ， 或 是 检测 到 传输 中 


。 在 中 断 服务 中 直接 解析 接收 到 的 字符 ， 然 后 通过 队列 将 解析 后 经 解码 得 到 的 命令 发 
送 到 处 理 任务 (与 图 23 中 描述 的 方式 类 似 ) 。 这 种 技术 仅 适 用 于 数据 流 能 够 快速 解析 


的 场合 






































， 这 样 整个 数据 解析 工作 才 可 以 放 在 中 断 服务 中 完成 。 





例 14. 利用 队列 在 中 断 服 务 中 发 送 或 接收 数据 


本 例 演示 在 同一 个 中 断 服务 





xQueueReceiveFromlSR()。 和 之 前 一 样 ， 采 用 软件 中 断 以 方便 实现 。 


创建 一 个 周期 任务 用 于 每 200 毫秒 往 队 列 中 发 送 五 个 数值 ， 





便 产 生 一 











个 软件 中 断 。 周 期 任务 的 实现 代码 参见 程序 清单 53。 


static void vIntegerGenerator( void *pvParameters ) 


{ 


portTickType xLastExecutionTime; 


unsigned portLONG ulValueToSend = 0; 


int i; 


/* 初始 化 变量 ， 用 于 调用 vTaskDelayUntil(). */ 


xLastExecutionTime = xTaskGetTickCount(); 





for( ;; ) 


( 


FreeRTOS 


Designed 











/* de^ EET. EAMES, PELBIABRAGSTIBUI ZI. JGIESERE2007E PETAT MX */ 
vTaskDelayUntil( &xLastExecutionTime, 200 / portTICK RATE MS ); 


























/* 连续 五 次 发 送 递增 数值 到 队列 。 这 此 数值 将 在 中 断 服 务 例 程 中 读 出 。 中 断 服 务 例 程 会 将 队列 读 空 ， 











以 此 任务 可 以 确保 将 所 有 的 数值 都 发 送 到 队列 。 因 此 不 需要 指定 阻塞 超时 时 间 / 

for( i = 0; i < 5; i++ ) 

{ 
xQueueSendToBack( xIntegerQueue, &ulValueToSend, 0 ); 
ulValueToSend++; 

} 

/* 产生 中 断 ， 以 让 中 断 服 务 例 程 读 取 队 列 * / 

vPrintString( "Generator task - About to generate an interrupt.\r\n" ); 

__asm{ int 0x82 } /* This line generates the interrupt. */ 


vPrintString( "Generator task - Interrupt generated.\r\n\r\n\r\n" ); 


程序 清单 53 例 14 中 的 写 队列 任务 实现 代码 
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中 使 用 xQueueSendToBackFromISR() 和 


五 个 数值 都 发 送 完 后 
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中 断 服 务 例 程 重复 调用 xQueueReceiveFromlSR(), 直到 被 周期 任务 写 到 队列 的 数 
值 都 被 读 出 ， 以 将 队列 读 空 。 每 个 接收 到 的 数值 的 低 两 位 用 于 一 个 字符 串 数 组 的 索引 ， 
被 索引 到 的 字符 串 的 指针 将 通过 调用 xQueueSendFromlSR() 发 送 到 另 一 个 队列 中 。 中 
断 服务 例 程 的 实现 代码 参数 程序 清单 54. 


static void interrupt _ far vExampleInterruptHandler( void ) 


{ 


static portBASE TYPE xHigherPriorityTaskWoken; 


static unsigned long ulReceivedNumber; 


/* 这 些 字符 串 被 声明 为 static const， 以 保证 它们 不 会 被 定位 到 ISR 的 栈 空间 中 ， 即 使 TSR 没有 运行 它们 也 是 存 
在 的 */ 
static const char *pcStrings[] = 


{ 





"String 0\r\n", 
"String 1\r\n", 
"String 2\r\n", 
"String 3\r\n" 













































































}; 
xHigherPriorityTaskWoken = pdFALSE; 
/* 重复 执行 ， 直 到 队列 为 空 */ 
while( xQueueReceiveFromISR( xIntegerQueue, 
&ulReceivedNumber, 
&xHigherPriorityTaskWoken ) !- errQUEUE EMPTY ) 
( 
/* 截断 收 到 的 数据 ， 保 留 低 两 位 (数值 范围 0 到 3) .然后 将 索引 到 的 字符 串 指针 发 送 到 另 一 个 队列 */ 
ulReceivedNumber &= 0x03; 
xQueueSendToBackFromISR( xStringQueue, 
&pcStrings[ ulReceivedNumber ], 
&xHigherPriorityTaskWoken ); 
j 
/* 被 队列 读 写 操作 解除 阻塞 的 任务 ， 其 优先 级 是 否 高 于 当前 任务 ”如 果 是 ， 则 进行 任务 上 下 文 切换 */ 
if( xHigherPriorityTaskWoken == pdTRUE ) 
{ 
/* 说 明 : 在 实际 使 用 中 ，ISR 中 强制 上 下 文 切换 的 宏 依 赖 于 有 具体 移植 。 此 处 调用 的 是 基于 open Watcom 
DOS 移 植 的 宏 。 其 它 平 台 下 的 移植 可 能 有 不 同 的 语法 要 求 。 对 于 实际 使 用 的 平台 ， 请 参 如 数 对 应 移植 自 价 
的 示例 程序 ， 以 决定 正确 的 语法 和 符号 。 */ 
portSWITCH CONTEXT () ; 
} 
} 


程序 清单 54 例 14 的 中 断 服务 例 程 实现 代码 
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另 一 个 任务 将 接收 从 中 断 服务 例 程 发 出 的 字符 串 指 针 。 此 任务 在 读 队 列 时 被 阻塞， 
直到 队列 中 有 消息 到 来 ， 并 将 接收 到 的 字符 串 打印 输出 。 其 实现 代码 参见 程序 清单 55。 


static void vStringPrinter( void *pvParameters ) 


{ 
char *pcString; 
for( ;; ) 
{ 
/* Block on the queue to wait for data to arrive. */ 


xQueueReceive( xStringQueue, &pcString, portMAX DELAY ); 


/* Print out the string received. */ 


vPrintString( pcString ); 


程序 清单 55 例 14 中 的 字符 串 接收 任务 实现 ， 其 接收 来 自 中 断 服务 例 程 的 字符 串 ， 并 打印 输出 





和 往 第 一 样 ，main() 函 数 创建 队列 和 任务 ， 然 后 局 动 调度 器 。 见 程序 清单 56。 
int main( void ) 
{ 
/* 队列 使 用 前 必须 先 创建 。 本 例 中 创建 了 两 个 队列 。 一 个 队列 用 于 保存 类 型 为 unsigned long 的 变量 ， 另 一 
个 队列 用 于 保存 类 型 为 cnar* 的 变量 。 两 个 队列 的 深度 都 为 10。 在 实际 应 用 中 应 当 检 测 返 回 值 以 确保 队列 创建 
成 功 */ 


xIntegerQueue = xQueueCreate( 10, sizeof( unsigned long ) ); 

















xStringQueue = xQueueCreate( 10, sizeof( char * ) ); 


/* 安装 中 断 服 务 例 程 。 */ 


dos setvect( 0x82, vExampleInterruptHandler ); 


/* 创建 任务 用 于 往 中 断 服 务 例 程 中 发 送 数值 。 此 任务 优先 级 为 1 */ 

xTaskCreate( vlIntegerGenerator, "IntGen", 1000, NULL, 1, NULL ); 
/* 创建 任务 用 于 从 中 断 服务 例 程 中 接收 字符 串 ， 并 打印 输出 。 此 任务 优先 级 为 2 */ 
xTaskCreate( vStringPrinter, "String", 1000, NULL, 2, NULL ); 

















/* Start the scheduler so the created tasks start executing. */ 


vTaskStartScheduler(); 











/* 如 果 一 切 正 常 ，main () 函数 不 会 执行 到 这 里 ， 因 为 调度 器 已 经 开始 运行 任务 。 但 如 果 程 序 运 行 到 了 这 里 ， 
很 可 能 是 由 于 系统 内 存 不 足 而 无 法 创建 空闲 任务 。 第 五 章 会 提供 更 多 关于 内 存 管理 的 信息 */ 


for( ;; ); 












































程序 清单 56 例 14 中 的 main() 函 数 实现 
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例 14 的 运行 输出 参见 图 33。 从 图 中 可 以 看 到 , 中 断 服 务 例 程 接收 到 所 有 五 个 数值 





并 以 五 个 字符 串 作 为 响应 。 更 多 解释 请 参考 图 34 





Interrupt generated. 


About to generate an interrupt. 


Interrupt generated. 


About to generate an interrupt. 


Interrupt generated. 














图 33 例 14 的 运行 输出 





f 





3 - The interrupt service routine both reads from a queue and writes to a queue, writing a L 
string to one queue for every integer received from another. Writing strings to a queue 
unblocks the StringPrinter task. 




















. A / |4- The StringPrinter task is the highest priority task N 
2 - The IntegerGenerator writes 5 values - |soruns immediately after interrupt service routine. It 
to a queue, then forces an interrupt ' | prints out each string it receives on a queue - when 
the queue is empty it enters the Blocked state, 
allowing the lower priority IntegerGenerator task to 























run again. 
Interrupt 
StringPrinter 
IntegerGenerator | | 
Idle ; — — N 
£3 ~ \ 
t ~ Time > 








1 - The Idle task runs most 
of the time. Every 200ms it 
gets preempted by the 
IntegerGenerator task. 


7 





5 - The IntegerGenerator task is a periodic task so 
blocks to wait for the next time period - once again 
the idle task is the only task able to run. In 200ms 
time the whole sequence will repeat. 


图 34 例 14 的 执行 流程 
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3.5 FIRE 


























最 新 的 FreeRTOS HH CVE TKE. "rice Hi XE FreeRTOSConfig.h 中 
定义 表 17 详细 列 出 的 一 个 或 两 个 常 
表 17 控制 中 断 谍 套 的 常量 





ir 
o 








描述 


是 


He 


configKERNEL_INTERRUPT_PRIORITY 设置 系统 心跳 时 钟 的 中 断 优先 级 。 





如 果 在 移植 中 没有 使 用 常量 
configMAX_SYSCALL INTERRUPT_PRIORITY， 那 
么 需要 调用 中 断 安全 版 本 FreeRTOS API 
的 中 断 都 必须 运行 在 此 优先 级 上 。 

















lim 
ium 














configMAX SYSCALL INTERRUPT PRIORITY 设置 中 断 安全 版 本 FreeRTOS API 可 以 运 
行 的 最 高 中 断 优 先 级 。 











建立 一 个 全 面 的 中 断 骨 套 模型 需要 设置 configMAX SYSCALL INTERRUPT. PRIRITY 
为 比 configKERNEL_INTERRUPT_PRIORITY 更 高 的 优先 级 。 这 种 模型 在 图 35 中 有 上 所 展示 。 
图 35 所 示 的 情形 假定 常量 configMAX_SYSCALL INTERRUPT PRIRITY 设置 为 3， 

















lim 

















configKERNEL INTERRUPT. PRIORITY 设置 为 1。 同 时 也 假定 这 种 情形 基于 一 个 具有 七 个 
不 同 中 断 优先 及 的 微 控制 器 。 这 里 的 七 个 优先 级 仅仅 是 本 例 的 一 种 假定 ， 并非 对 应 于 任 
何 一 种 特定 的 微 控制 器 架构 。 

在 任务 优先 级 和 中 断 优先 级 之 间 常 常会 产生 一 些 混淆 。 图 35 所 示 的 中 断 优先 级 是 
由 微 控制 器 架构 体系 所 定义 的 。 中断 优先 级 是 硬件 控制 的 优先 级 中断 服务 例 程 的 执行 
会 与 之 关联 。 任务 并 非 运行 在 中 断 服务 中 ,， 所 以 赋予 任务 的 软件 优先 级 与 赋予 中 断 源 的 
人 硬件 优先 级 之 间 没有 任何 关系 。 
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configMAX_SYSCALL_INTERRUPT_PRIORITY = 3 
configKERNEL INTERRUPT. PRIORITY = 1 








Priority 7 
Priority 6 使 用 这 些 优先 级 的 
中 断 不 会 被 内 核 延 
Priority 5 R, HETRE 
不 调用 任何 API 函 
数 的 中 断 可 以 使 Priority 4 
用 任何 一 个 优先 
OE BOE ES 
a Xe Va E] AP Tf 
_ 数 的 ISR 只 能 使 
nee 
‘ 
35 ”中断 控制 常量 影响 中 断 霸 套 行为 
如 图 35 所 示 : 


* 处 于 中 断 优先 级 1 到 3( 含 ) 的 中 断 会 被 内 核 或 处 于 临界 区 的 应 用 程序 阻塞 执行 , 但 是 


它们 可 以 调用 中 断 安全 版 本 的 FreeRTOS API 函数 


* 处 于 中 断 优先 级 4 及 以 上 的 中 断 不 受 临界 区 影响 ， 所 以 其 不 会 被 内 核 的 任何 行为 阻 


塞 ， 可 以 立即 得 到 执行 一 一 这 是 由 微 控 制 器 本 喘 对 中 断 优 先 级 的 限定 所 决定 的 。 通 
常 需 要 严格 时 间 精 度 的 功能 (如 电机 控制 ) 会 使 用 高 于 
configMAX_SYSCALL_INTERRUPT_PRIRITY 的 优先 级 ， 以 保证 调度 器 不 会 对 其 中 断 响 
应 时 间 造 成 抖动 。 





。 不 需要 调用 任何 FreeRTOS API 函数 的 中 断 ， 可 以 自由 地 使 用 任意 优先 级 。 
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对 ARM Cortex M3 用 户 的 一 点 提示 

Cortex M3 使 用 低 优先 级 号 数值 表示 逻辑 上 的 高 优先 级 中 断 。 这 显得 不 是 那么 直 
观 ， 所 以 很 容易 被 态 记 。 如 果 你 想 对 某 个 中 断 赋予 低 优先 级 ， 则 必须 使 用 一 个 高 优先 级 
号 数值 。 千 万 不 要 给 它 指定 优先 级 号 0( 或 是 其 它 低 优先 级 号 数值 )， 因 为 这 将 会 使 得 这 
个 中 断 在 系统 中 拥有 最 高 优先 级 一 一 如 果 这 个 优先 级 高 于 
configMAX_SYSCALL_INTERRUPT_PRIRITY, 44 HJ AE S S AEA iot o 

Cortex M3 内 核 的 最 低 优 先 级 为 255, 但 是 不 同 的 Cortex M3 处 理 器 厂商 实现 的 优 
先 级 位 数 不 尽 相同 ， 而 各 自 的 配套 库 函 数 也 使 用 了 不 同 的 方式 来 文 持 中 断 优先 级 。 比 如 
STM32, ST 的 驱动 库 中 将 最 低 优先 级 指定 为 15， 而 最 高 优先 级 指定 为 0。 
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4.1 概览 





多 任务 系统 中 存在 一 种 潜在 的 风险 。 当 一 个 任务 在 使 用 某 个 资源 的 过 程 中 ， 即 还 没 
有 完全 结束 对 资源 的 访问 时 ， 便 被 切 出 运行 态 ， 使 得 资源 处 于 非 一 致 ， 不 完整 的 状态 。 
如 果 这 个 时 候 有 另 一 个 任务 或 者 中 断 来 访问 这 个 资源 , 则 会 导致 数据 损坏 或 是 其 它 相 似 
的 错误 。 
以 下 便 是 一 些 例子 : 
1. 访问 外 设 
考虑 如 下 情形 ， 有 两 个 任务 都 试图 往 一 个 LCD 中 写 数据 : 
。 任 务 A 运行 ， 并 往 LCD 写字 符 串 "Hello world". 
。 任 务 A 被 任务 B 抢占 ,但 此 时 字符 串 才 输出 到 "Hello w” 
。 任 务 B 往 LCD "Abort, Retry, Fail?”?， 然 后 进入 阻塞 态 。 
。 任务 A 从 被 抢占 处 继续 执行 ， 完 成 剩余 的 字符 输出 一 一 “orld”。 
现在 LCD 显示 的 是 被 破坏 了 的 字符 串 ”Hello wAbort, Retry, Fail?orld”。 




















2.， 读 - 改 - 写 操作 

程序 清单 57 展现 的 是 一 段 C 代码 和 其 等 效 的 ARM7 汇编 代码 .可 以 看 出 , PORTA 
中 的 值 先 从 内 存 读 到 寄存 器 ， 在 寄存 器 中 完成 修改 ， 然 后 再 写 回 内 存 。 这 所 是 所 谓 的 读 
- 改 - 写 操作 。 


/* The C code being compiled. */ 
155: PORTA |= 0x01; 


/* The assembly code produced. */ 


0x00000264 481C LDR RO, [PC,#0x0070] ; Obtain the address of PORTA 
0x00000266 6801 LDR R1, [RO,#0x00] ; Read the value of PORTA into R1 
0x00000268 2201 MOV R2,#0x01 ; Move the absolute constant 1 into R2 
0x0000026A 4311 ORR R1,R2 ; OR R1 (PORTA) with R2 (constant 1) 
0x0000026C 6001 STR R1, [RO,#0x00] ; Store the new value back to PORTA 


程序 清单 57 ” 读 - 改 - 写 过 程 示 例 
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这 是 一 个 " 非 原 子 " 操 作 ， 因 为 完成 整个 操作 需要 不 止 一 条 指令 ， 所 以 操作 过 程 可 能 
被 中 断 。 考 虑 如 下 情形 ， 两 个 任务 都 试图 更 新 一 个 名 为 PORTA 的 内 存 映 射 寄存 器 

。 任 务 A 把 PORTA 的 值 加 载 到 寄存 器 中 一 一 整个 流程 的 读 操作 。 

。 在 任务 A 完成 整个 流程 的 改 和 写 操作 之 前 ， 被 任务 B 抢占 。 

© (£4 B 完整 的 执行 了 对 PORTA 的 更 新 流程 ， 然 后 进入 阻塞 态 。 

© 任务 A 从 被 抢占 处 继续 执行 。 其 修改 了 一 个 PORTA 的 拷贝 ， 这 其 实 只 是 寄存 

器 在 任务 A 回 写 到 PORTA 之 前 曾经 保存 过 的 值 。 

任务 A 更 新 并 回 写 了 一 个 过 期 的 PORTA 寄存 器 值 。 在 任务 A 获得 拷贝 与 更 新 回 
写 之 间 ， 任 务 B 又 修改 了 PORTA 的 值 。 而 之 后 任务 A 对 PORTA WSHE, Zu 
了 任务 B 对 PORTA 进行 的 修改 结果 ， 效 果 上 等 同 于 破坏 了 PORTA 寄存 器 的 值 。 

虽然 是 以 一 个 外 围 设备 寄存 器 为 例 ， 但 是 整个 情形 同样 适用 于 全 局 变量 的 读 - 改 - 写 
操作 。 









































3. 变量 的 非 原子 访问 

更 新 结构 体 的 多 个 成 员 变 量 ， 或 是 更 新 的 变量 其 长 度 超过 了 架构 体系 的 自然 长 度 
(比如 ， 更 新 一 个 16 位 机 上 的 32 位 变量 ) 均 是 非 原子 操作 的 例子 。 如 果 这 样 的 操作 被 中 
其， 将 可 能 导致 数据 损坏 或 丢失 。 





























4. 函数 重 入 

如 果 一 个 函数 可 以 安全 地 被 多 个 任务 调用 , 或 是 在 任务 与 中 断 中 均 可 调用 , 则 这 个 
函数 是 可 重 入 的 。 

每 个 任务 都 单独 维护 自己 的 栈 空 间 及 其 自身 在 的 内 存 寄存 器 组 中 的 值 。 如 果 一 个 函 
数 除了 访问 自己 栈 空间 上 分 配 的 数据 或 是 内 核 寄存 器 中 的 数据 外 ， 不 会 访问 其 它 任何 
数据 ， 则 这 个 函数 就 是 可 重 入 的 。 程 序 清单 58 示例 了 一 个 可 重 入 函数 ， 而 程序 清单 59 
是 一 个 不 可 重 入 函数 的 例子 。 





























FreeRTOS 98 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http://www.FreeRTOS.org 


/* A parameter is passed into the function. This will either be 
passed on the stack or in a CPU register. Either way is safe as 
each task maintains its own stack and its own set of register 
values. */ 
long lAddOneHundered( long lVarl ) 
{ 
/* This function scope variable will also be allocated to the stack 
or a register, depending on compiler and optimization level. Each 
task or interrupt that calls this function will have its own copy 
of lVar2. */ 
long 1Var2; 

lVar2 = lVarl + 100; 


/* Most likely the return value will be placed in a CPU register, 
although it too could be placed on the stack. */ 


return lVar2; 


程序 清单 58 可 重 入 函数 示例 


/* In this case lVarl is a global variable so every task that calls 

the function will be accessing the same single copy of the variable. */ 
long lVarl; 

long lNonsenseFunction( void ) 

{ 

/* This variable is static so is not allocated on the stack. Each task 
that calls the function will be accessing the same single copy of the 
variable. */ 

static long 1State = 0; 


long lReturn; 


switch( 1State ) 
case 0 : lReturn = lVarl + 10; 
lState = 1; 


break; 


case 1 : lReturn = lVarl + 20; 
lState - 0; 


break; 


程序 清单 59 ”不 可 重 入 函数 示例 
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Hj 

访问 一 个 被 多 任务 共享 ， 或 是 被 任务 与 中 断 共 享 的 资源 时 ， 需 要 采用 " 互 斥 " 技 术 以 
保证 数据 在 任何 时 候 都 保持 一 致 性 。 这 样 做 的 目的 是 要 确保 任务 从 开始 访问 资源 就 具有 
排 它 性 ， 直 至 这 个 资源 又 恢复 到 完整 状态 。 

FreeRTOS 提供 了 多 种 特性 用 以 实现 互 斥 ， 但 是 最 好 的 互 斥 方法 〈 如 果 可 能 的 话 ， 
任何 时 候 都 当 如 此 ) 还 是 通过 精心 设计 应 用 程序 ， 尺 量 不 要 共享 资源 , 或 者 是 每 个 资源 
通过 单 任 务 访问 。 












































本 章 期 望 让 读者 了 解 以 下 内 容 : 
。 为 什么 ， 以 及 在 什么 时 候 有 必要 进行 资源 管理 与 控制 。 
e 什么 是 临界 区 。 
。 互 斥 是 什么 意思 。 
。 挂 起 调度 器 有 什么 意义 
。 如 何 使 用 互 斥 量 。 
。 如 何 创 建 与 使 用 守护 任务 。 
。 什 么 是 优先 级 反 转 ， 以 及 优先 级 继承 是 如 何 减 小 (但 不 是 消除 ) 其 影响 的 。 
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4.2 临界 区 与 挂 起 调度 器 


基本 临界 区 
基本 临界 区 是 指 宏 taskENTER, CRITICAL()-5 taskEXIT_CRITICAL() 之 间 的 代码 
区 间 ， 程 序 清单 60 是 一 段 范 例 代 码 。Critical Sections 也 被 称 作 Critical Regions. 





/* 为 了 保证 对 PORTR 寄 存 器 的 访问 不 被 中 断 ， 将 访问 操作 放 入 临界 区 。 
进入 临界 区 * / 
taskENTER CRITICAL(); 























/* 在 taskENTER CRITICAL() 5 taskEXIT CRITICAL () 之 间 不 会 切换 到 其 它 任务 。 中 断 可 以 执行 ， 也 允许 
RE, 但 只 是 针对 优先 级 高 于 configMAX SYSCALL INTERRUPT PRIORITY 的 中 断 -而且 这 些 中 断 不 允许 访问 
FreeRTOS API pA. */ 

PORTA |= 0x01; 











/* 我 们 已 经 完成 了 对 PORTA 的 访问 ， 因 此 可 以 安全 地 离开 临界 区 了 。 */ 
taskEXIT CRITICAL(); 


程序 清单 60 使 用 临界 区 对 寄存 器 的 访问 进行 保护 





本 书 采用 的 范例 工程 使 用 了 一 个 名 为 vPrintString() 的 函数 ,用 以 往 标准 输出 设备 写 
字符 串 。 这 个 标准 输出 即 是 Open Watcom DOS 可 执行 程序 的 终端 窗口 。vPrintString() 
被 多 个 不 同 的 任务 调用 , 所 以 理论 上 其 函数 实现 中 应 当 使 用 一 个 临界 区 对 标准 输出 进行 
保护 。 如 程序 清单 61 所 示 。 
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void vPrintString( const portCHAR *pcString ) 
{ 
/* 往 stdout 中 写字 符 串 ， 使 用 临界 区 这 种 原始 的 方法 实现 互 斥 。 */ 
taskENTER CRITICAL () ; 
{ 
printf( "%s", pcString ); 
fflush( stdout ); 


) 


taskEXIT CRITICAL(); 








/* 允许 按 任意 键 停止 应 用 程序 运行 。 实 际 的 应 用 程序 如 果 有 使 用 到 键 值 ， 还 需要 对 键盘 输入 进行 保护 。 */ 
if( kbhit() ) 


{ 


vTaskEndScheduler () ; 


} 


程序 清单 61 vPrintString() 的 一 种 可 能 的 实现 方法 

















临界 区 是 提供 互 斥 功能 的 一 种 非常 原始 的 实现 方法 。 临界 区 的 工作 仅仅 是 简单 地 把 
中 断 全 部 关 掉 ， 或 是 关 掉 优先 级 在 configMAX_SYSCAL INTERRUPT PRIORITY X 
以 下 的 中 断 一 一 依赖 于 具体 使 用 的 FreeRTOS 移植 。 抢 占 式 上 下 文 切换 只 可 能 在 某 个 
中 断 中 完成 ， 所 以 调用 taskENTER_CRITICAL() 的 任务 可 以 在 中 断 关闭 的 时 段 一 直 保 
持 运行 态 ， 直 到 退出 临界 区 。 

临界 区 必须 只 具有 很 短 的 时 间 ， 否 则 会 反 过 来 影响 中 断 响应 时 间 。 在 每 次 调用 
taskENTER_CRITICAL() 之 后 , 必须 尽快 地 配套 调用 一 个 taskEXIT_CRITICAL()。 从 这 
个 角度 来 看 ， 对 标准 输出 的 保护 不 应 当 采 用 临界 区 (如 程序 清单 61 所 示 )， 因 为 写 终端 
在 时 间 上 会 是 一 个 相对 较 长 的 操作 。DOS 模拟 器 和 Open Watcom 处 理 终端 输出 时 没 
有 采用 这 种 互 扩 方式， 其 库 函 数 中 是 没有 关中 断 的 。 本 章 中 的 示例 代码 会 探索 其 它 解决 

临界 区 髓 套 是 安全 的 ， 因 为 内 核 有 维护 一 个 嵌 套 深度 计数 。 临 界 区 只 会 在 骨 套 深度 
为 0 时 才 会 真正 退出 一 一 即 在 为 每 个 之 前 调用 的 taskENTER_CRITICAL() 都 配套 调用 
J taskEXIT. CRITICAL()Z JF « 
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挂 起 (锁定 ) 调 度 器 

也 可 以 通过 挂 起 调度 器 来 创建 临界 区 。 挂 起 调度 器 有 些 时 候 也 被 称 为 锁定 调度 器 。 
基本 临界 区 保护 一 段 代 码 区 间 不 被 其 它 任务 或 中 断 打 断 。 由 挂 起 调度 器 实现 的 临界 
区 只 可 以 保护 一 段 代码 区 间 不 被 其 它 任 务 打 断 ， 因 为 这 种 方式 下 ， 中 断 是 使 能 的 。 

如 果 一 个 临界 区 太 长 而 不 适合 简单 地 关中 断 来 实现 , 可 以 考虑 采用 挂 起 调度 器 的 方 
Io 但 是 唤醒 (resuming, or un-suspending) 调 度 器 却 是 一 个 相对 较 长 的 操作 。 所 以 评估 
哪 种 是 最 佳 方式 需要 结合 实际 情况 。 















































vTaskSuspendAII() API 函数 


void vTaskSuspendAll( void ); 


程序 清单 62 vTaskSuspendAIl() API 函数 原型 
通过 调用 vTaskSuspendAll() 来 挂 起 调度 器 。 挂 起 调度 器 可 以 停止 上 下 文 切换 而 不 
用 关中 断 。 如 果 某 个 中 断 在 调度 器 挂 起 过 程 中 要 求 进行 上 下 文 切换 ， 则 个 这 请 求 也 会 被 
挂 起 ， 直 到 调度 器 被 唤醒 后 才 会 得 到 执行 。 





在 调度 器 处 于 挂 起 状态 时 ， 不 能 调用 FreeRTOS API 函数 。 


xTaskResumeAll( API 函数 


portBASE TYPE xTaskResumeAll( void ); 


程序 清单 63 xTaskResumeAll() API e Zi Ji 7i 
K 18 xTaskResumeAll()i EHME 





参数 名 描述 


返回 值 在 调度 器 挂 起 过 程 中 ， 上 下 文 切换 请 求 也 会 被 挂 起 ， 直 到 调度 器 
被 唤醒 后 才 会 得 到 执行 。 如 果 一 个 挂 起 的 上 下 文 切 换 请 求 在 
xTaskResumeAll() 返 回 前 得 到 执行 ， 则 函数 返回 pdTRUE。 在 其 

它 情 况 下 ，xTaskResumeAll() 返 回 pdFALSE. 
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REH vTaskSuspendAll() ll xTaskResumeAll() 是 安全 的 , 因为 内 核 有 维护 一 个 
KEREI. MERR SERERE 0 时 才 会 被 唤醒 一 一 即 在 为 每 个 之 前 调用 
的 vTaskSuspendAll() 都 配套 调用 了 xTaskResumAIl() Z Jci » 

程序 清单 64 展示 了 实际 使 用 的 vPrintString() 实 现代 码 。 这 种 实现 方式 即 是 通过 挂 
起 调度 器 的 方式 来 保护 终端 输出 。 








void vPrintString( const portCHAR *pcString ) 
{ 
/* Write the string to stdout, suspending the scheduler as a method 
of mutual exclusion. */ 
vTaskSuspendScheduler () ; 
{ 
printf( "%s", pcString ); 
fflush( stdout ); 


} 


xTaskResumeScheduler () ; 


/* Allow any key to stop the application running. A real application that 
actually used the key value should protect access to the keyboard input too. */ 
if( kbhit() ) 


{ 


vTaskEndScheduler () ; 


程序 清单 64 _vPrintString() 实 现代 码 
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4.3 互 斥 量 (及 二 值 信 

用 于 控制 在 两 个 或 多 个 任务 间 访 问 共享 资源 。 单 
源 关 联 的 令 牌 。 一 个 任务 想 


互 斥 量 是 一 种 特殊 的 二 值 信号 量 ， 
) 源 于 "MUTual Exclusion’. 

在 用 于 互 斥 的 场合 , 互 斥 量 从 概念 上 可 看 作 是 与 共享 
须 先 成 功 地 得 到 (Take) 该 资源 对 应 的 令 牌 (成 为 令 牌 持 有 者 ) 
只 有 归还 了 令 牌 ， 其 它 任 务 
否则 不 




















享 资源 














词 MUTEX( 互 斥 量 
(Give) 令 牌 。 
一 个 任务 除非 持 有 了 令 有 牌 








， 其 必 
其 必须 马上 归还 





7 ON 














要 合法 地 访问 资源 
令 牌 持 有 者 完成 资源 使 用 

功 持 有 ， 也 才 可 能 安全 地 访问 该 共享 资源 。 

之 间 具 有 很 多 相同 的 特性 , 但 图 36 展示 的 情形 ( 互 斥 量 用 

两 者 间 最 大 的 区 别 在 






































才 可 能 成 功 持 
允许 访问 共享 资源 。 这 种 机 制 在 图 36 中 展示 。 
e/g Hf ut 
多 (二 值 信号 量 用 于 同步 )。 

















UA He 
于 互 斥 功能 ) 完 全 不 同 于 图 30 展示 的 情形 ( 
在 被 获得 之 后 所 发 生 的 事情 : 












































于 信和 号 量 
。 用 于 互 斥 的 信号 量 必须 归还 。 
s。 用 于 同步 的 信号 量 通常 是 完成 同步 之 后 便 丢 弃 ， 不 再 归 
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The resource being 


guarded by the mutex 
kA 
The mutex used to = 


guard the resource 


Guarded 
resource 





Two tasks each want to access the resource, but a task is not permitted to access the 
resource unless it is the mutex (token) holder. 











Guarded 








resource 








Task A attempts to take the mutex. Because the mutex is available Task A successfully 
becomes the mutex holder so is permitted to access the resource. 
















Guarded 
resource 


Task B executes and attempts to take the same mutex. Task A still has the mutex so the 
attempt fails and Task B is not permitted to access the guarded resource. 








Guarded 
resource 








xSemaphoreTake() 


Task B opts to enter the Blocked state to wait for the mutex - allowing Task A to run again. 
Task A finishes with the resource so 'gives' the mutex back. 








askA 













Guarded 
resource 











Task A giving the mutex back causes Task B to exit the Blocked state (the mutex is now 
available). Task B can now successfully obtain the mutex, and having done so is permitted to 
access the resource. 








ask A 


Guarded 
resource 





When Task B finishes accessing the resource it too gives the mutex back. The mutex is now 
once again available to both tasks. 











图 36 互 斥 量 用 于 互 斥 功 能 
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这 种 机 制 纯粹 是 工作 于 应 用 程序 作者 制定 的 规则 之 下 。 任务 不 是 在 任何 时 候 都 可 以 
访问 资源 是 不 需要 理由 的 , 因为 这 是 所 有 任务 达成 的 一 致 ， 除 非 它们 能 成 为 互 斥 量 的 持 
有 者 。 

















xSemaphoreCreateMutex() API 函数 
互 斥 量 是 一 种 信号 量 。FreeRTOS 中 所 有 种 类 的 信号 量 句柄 都 保存 在 类 型 为 
xSemaphoreHandle 的 变量 中 。 




























































































互 斥 量 在 使 用 前 必须 先 创建 。 创 建 一 个 互 斥 量 类 型 的 信号 量 需 要 使 用 
xSemaphoreCreateMutex() API 函数 。 
xSemaphoreHandle xSemaphoreCreateMutex( void ); 
程序 清单 65 xSemaphoreCreateMutex() API 函数 原型 
#219 xSemaphoreCreateMutex()ix [u| fit 
参数 名 描述 
返回 值 如 果 返 回 NULL 表示 互 斥 量 创建 失败 。 原 因 是 内 存 堆 空间 不 足 导致 
FreeRTOS 无 法 为 互 斥 量 分 配 结构 数据 空间 。 第 五 章 提 供 更 多 关于 内 存 














管理 方面 的 信息 。 

















返回 非 NULL 值 表示 互 斥 量 创建 成 功 。 返 回 值 应 当 保存 起 来 作为 该 互 斥 
HLA AAA o 














例 15. 使 用 信和 号 量 重 写 vPrintString() 

本 例 创 建 了 一 个 新 版 本 的 vPrintString()， 称 为 prvNewPrintString()， 然 后 在 多 任务 
中 调用 这 个 新 版 函数 。prvrNewPrintString() 具 有 与 vPrintString() 完 全 相同 的 功能 ， 只 是 
在 实现 上 使 用 互 斥 量 代替 基本 临界 区 来 实现 对 标准 输出 的 控制 。prvNewPrintString() 的 
实现 代码 参见 程序 清单 66。 
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static void prvNewPrintString( const portCHAR *pcString ) 


{ 


prvPrintTask() 的 实现 代码 参见 程序 清单 67。 


/* 互 斥 量 在 调度 器 启动 之 前 就 已 创建 ， 所 以 在 此 任务 运行 时 信号 量 就 





试图 获得 互 斥 量 。 如 果 互 斥 量 无 效 ， 则 将 阻塞 ， 进 入 无 超时 等 符 。 








斥 量 后 返 巴 




















， 所 以 无 需 检测 返回 值 。 如 果 指 定 了 等 待 超时 时 





2H 
AT 
pup, MARE sixsemaphoreTake () 返回 





只 可 能 在 成 功 获得 互 


xSemaphoreTake () 























访问 标准 输出 ， 因 为 任意 时 刻 只 会 有 一 个 任 








pdTRUE 后 ， 才 能 访问 共享 资源 (此 处 是 指标 准 输出 ) 。 */ 
xSemaphoreTake( xMutex, portMAX DELAY ); 
( 
/* Ferry Blix BRA CAMO A Fei. IMEA A B 
务 能 持 有 互 斥 量 。 */ 
printf( "£s", pcString ); 
fflush( stdout ); 
/* 互 斥 量 必须 归还 ! */ 
} 


xSemaphoreGive( xMutex ); 


/* Allow any key to stop the application running. A real application that 


actually used the key value should protect access to the keyboard too. A 


real application is very unlikely to have more than one task processing 


key presses though! */ 


if( kbhit() ) 


( 


vTaskEndScheduler () ; 


程序 清单 66 ”prvNewPrintString() 实 现代 码 


prvNewPrintString() 被 一 个 任务 的 两 个 实例 重复 调用 。 在 每 次 调用 之 间 采 用 了 一 个 
随机 延迟 时 间 。 任 务 的 入 口 参数 用 于 向 任务 的 每 个 实例 传递 各 自 的 输出 字符 串 。 任 务 
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static void prvPrintTask( void *pvParameters ) 


( 


char *pcStringToPrint; 


/* Two instances of this task are created so the string the task will send 


to prvNewPrintString() is passed into the task using the task parameter. 
Cast this to the required type. */ 


pcStringToPrint = ( char * ) pvParameters; 


for( ;; ) 
{ 
/* Print out the string using the newly defined function. */ 


prvNewPrintString( pcStringToPrint ); 








/* 等 待 一 个 伪 随 机 时 间 。 注 意 函数 *anad () 不 要 求 可 重 入 ， 因 为 在 本 例 中 rand () 的 返回 值 并 不 重要 。 但 


















































在 安全 性 要 求 更 高 的 应 用 程序 中 ， 需 要 用 一 个 可 重 入 版 本 的 rand () 函数 - 或 是 在 临界 区 中 调 
函数 。 */ 
vTaskDelay( ( rand() & Ox1FF ) ); 








程序 清单 67 例 15 中 任务 prvPrintTask() 的 实现 代码 








]rand() 














和 往 第 一 样 ，main() 函 数 简单 地 创建 互 斥 量 ， 创 建 任 务 ， 然 后 启动 调度 器 。 具 体 实 





现代 人 码 参见 程序 清单 68。 





任务 prvPintTask() 的 两 个 实例 在 创建 时 指定 了 不 同 的 优先 级 。 所 以 运行 时 ， 低 优 
先 级 任务 在 有 些 时 候 会 被 高 优先 级 的 任务 抢占 。 由 于 使 用 了 互 斥 量 来 保证 每 个 任务 在 访 























问 终端 时 保持 互 斥 ， 所 以 即使 是 任务 被 抢占 ， 字 符 串 也 会 正确 显示 ， 而 不 会 有 其 











它 导致 


破坏 的 可 能 。 任务 的 抢占 频率 还 可 以 再 提高 , 只 需要 减少 任务 在 阻塞 态 中 花费 的 最 长 时 


间 ， 本 例 中 这 个 最 长 时 间 默 认为 0x1ff 个 系统 心跳 周期 。 
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int main( void ) 


{ 





/* fe Se A WOE OE. ASB SERERA / 


xMutex = xSemaphoreCreateMutex () ; 

















/* 本 例 中 的 任务 会 使 用 一 个 随机 延迟 时 间 ， 这 里 给 随机 数 发 生 器 生成 种 子 。 */ 
srand( 567 ); 


/* Check the semaphore was created successfully before creating the tasks. */ 
if( xMutex != NULL ) 
{ 
/* Create two instances of the tasks that write to stdout. The string 
they write is passed in as the task parameter. The tasks are created 
at different priorities so some pre-emption will occur. */ 
xTaskCreate( prvPrintTask, "Printi", 1000, 
"Task 1 *xdkkdek ok ke dede ke e dee e dee e dee e dee ee deese kk Ny NS", 1, NULL ); 
xTaskCreate( prvPrintTask, "Print2", 1000, 
"Task 2 ------------------------------------------ \r\n", 2, NULL ); 


/* Start the scheduler so the created tasks start executing. */ 


vTaskStartScheduler () ; 




















/* WAT YER, main () 函数 不 会 执行 到 这 里 ， 因 为 调度 器 已 经 开始 运行 任务 。 但 如 果 程序 运行 到 了 这 里 ， 
很 可 能 是 由 于 系统 内 存 不 足 而 无 法 创建 空闲 任务 。 第 五 草 会 提供 更 多 关于 内 存 管 理 的 信息 */ 


for( ;; ): 
























































程序 清单 68 例 15 的 main() 函 数 实现 
图 37 展示 了 例 15 的 运行 输出 结果 。 一 种 可 能 的 执行 流程 参见 图 38. 














图 37 例 15 的 输出 结果 
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从 图 37 中 可 以 看 到 ， 和 所 期 望 的 一 样 ， 终 端 上 显示 的 字符 串 没 有 遭 到 破坏 。 随 机 
的 显示 顺序 是 任务 采用 随机 延迟 周期 的 结果 。 











3-Task 2 attempts to take the mutex, but the mutex is still he 
by Task 1 so Task 2 enters the Blocked state, allowing Task 1 























to execute again. 
| 5 - Task 2 writes out its string, gives back the 
2 - Task 1 takes the mutex and starts to i semaphore, then enters the Blocked state to wait 
write out its string. Before the entire string i for the next execution time. This allows Task 1 to 
has been output Task 1 is preempted by the | run again - Task 1 also enters the Blocked state to 
higher priority Task 2. : | wait for its next execution time leaving only the Idle 
> i task to run. 
Task 2 | || 7 
Task 1 





Ide = 
| 1 Time 








back the mutex - causing Task 2 to exit the Blocked 


state. Task 2 preempts Task 1 again 


1 - The delay period for Task 1 expires so 
Task 1 pre-empts the idle task. 


4 - Task 1 completes writing out its string, and ur 











图 38 fi) 15 中 一 种 可 能 的 执行 流程 


优先 级 反 转 

图 38 也 展现 出 了 采用 互 斥 量 提 供 互 斥 功能 的 潜在 缺陷 乙 一 。 在 这 种 可 能 的 执行 流 
程 描述 中 ， 高 优先 级 的 任务 2 竟然 必须 等 待 低 优先 级 的 任务 1 放弃 对 互 斥 量 的 持 有 权 。 
高 优先 级 任务 被 低 优 先 级 任务 阻塞 推迟 的 行为 被 称 为 "优先 级 反 转 "。 这 是 一 种 不 合理 的 
行为 方式 ， 如 果 把 这 种 行为 再 进一步 放大 ， 当 高 优先 级 任务 正 等 竺 信号 量 的 时 候 ， 一 个 
介 于 两 个 任务 优先 之 间 的 中 等 优先 级 任务 开始 执行 一 一 这 就 会 时 致 一 个 高 优先 级 任务 
在 等 竺 一 个 低 优先 级 任务 ， 而 低 优先 级 任务 却 无 法 执行 ! 这 种 最 坏 的 情形 在 图 39 中 进 
行 展 示 。 
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2 - The HP task attempts to take the mutex 
but can’t because it is still being held by the 
LP task. The HP task enters the Blocked 
state to wait for the mutex to become 


4 - The MP task is now running. The HP 
task is still waiting for the LP task to return 
the mutex, but the LP task is not even 























available. secu 
High priority task [HP] E 
Medium priority task [MP] : — 
Low priority task [LP] / ! 
t Time 








3 - The LP task continues to execute, but 
gets preempted by the MP task before it 
gives the mutex back. 






1 - The LP task takes a mutex before being 
preempted by the HP task. 








图 40 ”优先 级 反 转 的 一 种 最 坏 情 况 





优先 级 反 转 可 能 会 产生 重大 问题 。 但 是 在 一 个 小 型 的 能 入 式 系统 中 , 通常 可 以 在 设 
计 阶 段 就 通过 规划 好 资源 的 访问 方式 避免 出 现 这 个 问题 。 





优先 级 继承 

FreeRTOS 中 互 斥 量 与 二 值 信号 量 十 分 相似 一 一 唯一 的 区 别 就 是 互 斥 量 自动 提供 
了 一 个 基本 的 ”优先 级 继承 ”机制 。 优 先 级 继承 是 最 小 化 优先 级 反 转 负面 影响 的 一 种 方案 
一 一 其 并 不 能 修正 优先 级 反 转 带 来 的 问题 , 仅仅 是 减 小 优先 级 反 转 的 影响 。 优 先 级 继承 
使 得 系统 行为 的 数学 分 析 更 为 复杂 ， 所 以 如 果 可 以 避免 的 话 ， 并 不 建议 系统 实现 对 优先 
级 继承 有 所 依赖 。 

优先 级 继承 暂时 地 将 互 斥 量 持 有 者 的 优先 级 提升 全 所 有 等 待 此 互 斥 量 的 任务 所 有 
有 的 最 高 优先 级 。 持 有 互 斥 量 的 低 优先 级 任务 ”继承 "了 等 待 互 斥 量 的 任务 的 优先 级 。 这 
种 机 制 在 图 40 中 进行 展示 。 互 斥 量 持 有 者 在 归还 互 斥 量 时 ， 优 先 级 会 自动 设置 为 其 原 
来 的 优先 级 。 





























ell 
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4 - The LP task returning the mutex causes the HP task to 
exit the Blocked state as the mutex holder. When the HP 
task has finished with the mutex it gives it back. The MP 

task only executes when the HP task returns to the Blocked 








2 - The HP task attempts to take the mutex but can't 
because it is still being held by the LP task. The HP task 
enters the Blocked state to wait for the mutex to become 





























: state so the MP task never holds up the HP task. 
available. > 

High priority task [HP]  : 

Medium priority task [MP] 

Low priority task [LP] | 

"t Time. 

1 - The LP task takes a mutex before being | | 3- The LP task is preventing the HP task from executing so inherits | 
preempted by the HP task. the priority of the HP task. The LP task cannot now be preempted by 











the MP task, so the amount of time that priority inversion exists is 
minimized. When the LP task gives the mutex back it returns to its 
original priority. 


图 40 优先 级 继承 最 小 化 优先 级 反 转 的 影响 
由 于 最 好 是 优先 考虑 避免 优先 级 反 转 ， 并 且 因为 FreeRTOS 本 身 是 面向 内 存 有 限 
的 微 控制 器 , 所 以 只 实现 了 最 基本 的 互 斥 量 的 优先 级 继承 机 制 , 这 种 实现 假定 一 个 任务 
在 任意 时 刻 只 会 持 有 一 个 互 斥 量 。 

















死 锁 是 利用 互 斥 量 提 供 互 斥 功能 的 另 一 个 潜在 缺陷 。Deadlock 有 了 时候 会 被 更 戏 居 
性 地 称 为 "deadly embrace( 抱 死 )”。 
当 两 个 任务 都 在 等 待 被 对 方 持 有 的 资源 时 ， 两 个 任务 都 无 法 再 继续 执行 ， 这 种 情况 
就 被 称 为 死 锁 。 考 虑 如 下 情形 ， 任 务 A 与 任务 B 都 需要 获得 互 斥 量 X GA eat Y 以 完 
成 各 自 的 工作 : 
1. 任务 A 执行 ， 并 成 功 获得 了 互 斥 量 X。 
2. 任务 A 被 任务 B 抢占 。 
3. 任务 B 成功 获得 了 互 斥 量 Y， 之 后 又 试图 获取 互 斥 量 XH HRE X 已 
经 被 任务 A 持 有 ， 所 以 对 任务 B 无 效 。 任务 B 选择 进入 阻塞 态 以 等 待 互 斥 
E X 被 释放 。 
4. 任务 A 得 以 继续 执行 。 其 试图 获取 互 斥 量 Y 一 一 但 互 斥 量 Y 已 经 被 任务 B 
持 有 而 对 任务 A 无效 。 任 务 A 也 选择 进入 阻塞 态 以 等 待 互 斥 量 Y 被 释放 。 
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这 种 情形 的 最 终结 局 是 ， 任 务 A 在 等 待 一 个 被 任务 B 持 有 的 互 斥 量 ， 而 任务 B 也 
年 等 待 一 个 被 任务 A 持 有 的 互 太 量 。 死 锁 于 是 发 生 ， 因 为 两 个 任务 都 不 可 能 再 执行 下 
去 了 。 

和 优先 级 反 转 一 样 ， 避 免 死 锁 的 最 好 方法 就 是 在 设计 阶段 就 考虑 到 这 种 潜在 风险 ， 
这 样 设计 出 来 的 系统 就 不 应 该 会 出 现 死 锁 的 情况 。 于 实践 经 验 而 言 ， 对 于 一 个 小 型 嵌入 
式 系统 ， 死 锁 并 不 是 一 个 大 问题 ， 因 为 系统 设计 者 对 整个 应 用 程序 都 非常 清楚 ， 所 以 能 
够 找 出 发 生死 锁 的 代码 区 域 ， 并 消除 死 锁 问题 。 
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4.4 守护 任务 








守护 任务 提供 了 一 种 干净 利落 的 方法 来 实现 互 斥 功能 , 而 不 用 担心 会 发 生 优先 级 反 
转 和 死 锁 。 

守护 任务 是 对 某 个 资源 具有 唯一 所 有 权 的 任务 。 只 有 守护 任务 才 可 以 直接 访问 其 守 
护 的 资源 一 一 其 它 任务 要 访问 该 资源 只 能 间接 地 通过 守护 任务 提供 的 服务 。 





























例 16. 采用 守护 任务 重 写 vPrintString() 

例 16 提供 了 vPrintString() 的 男 一 种 实现 方法 ， 这 里 采用 了 一 个 守护 任务 来 管理 对 
标准 输出 的 访问 。 当 一 个 任务 想 要 往 终 端 写 信息 的 时 候 ， 其 不 能 直接 调用 打印 函数 ， 而 
是 将 消息 发 送 到 守护 任务 。 

守护 任务 使 用 了 一 个 FreeRTOS 队列 来 对 终端 实现 串 行 化 访问 。 该 任务 内 部 实现 
不 必 考 虑 互 斥 ， 因 为 它 是 唯一 能 够 直接 访问 终端 的 任务 。 

守护 任务 大 部 份 时 间 都 在 阻塞 态 等 待 队列 中 有 信息 到 来 。 当 一 个 信息 到 达 时 ， 守 护 
任务 仅仅 简单 地 将 收 到 的 信息 写 到 标准 输出 上 ， 然 后 又 返回 阻塞 态 ， 继 续 等 待 下 一 条 信 
县 地 到 来 。 守 护 任 务 的 具体 实现 参见 程序 清单 70。 

中 断 中 可 以 写 队列 ， 所 以 中 断 服 务 例 程 也 可 以 安全 地 使 用 守护 任务 提供 的 服务 ， 从 
而 把 信息 输出 到 终端 。 在 本 例 中 ， 一 个 心跳 中 断 钧 子 函数 用 于 每 200 心跳 周期 就 输出 
一 个 消息 。 

心跳 钧 子 函数 (或 称 回 调 函 数 ) 由 内 核 在 每 次 心跳 中 断 时 调用 。 要 挂 接 一 个 心跳 钩子 
函数 ， 需 要 做 以 下 配置 : 

。 设置 FreeRTOSConfig.h 中 的 常量 configUSE_TICK_HOOK 为 1。 


































































































。 提供 钩子 函数 的 具体 实现 ， 要 求 使 用 程序 清单 69 中 的 函数 名 和 原型 。 




















void vApplicationTickHook( void ) 


程序 清单 69 BAT RBA SURE 


心跳 钩子 函数 在 系统 心跳 中 断 的 上 下 文 上 执行 ,所 以 必须 保证 非常 短小 ,适度 占用 
栈 空 间 ， 并 且 不 要 调用 任何 名 字 不 带 后 绥 "FromlSR" 的 FreeRTOS API Až. 
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static void prvStdioGatekeeperTask( void *pvParameters ) 


{ 


char *pcMessageToPrint; 
/* 这 是 唯一 允许 直接 访问 终端 输出 的 任务 。 任 何其 它 任务 想 要 输出 字符 串 ， 都 不 能 直接 访问 终端 ， 而 是 将 要 
输出 的 字符 串 发 送 到 此 任务 。 并 且 因 为 具有 本 任务 才 可 以 访问 标准 得 出， 所 以 本 任务 在 实现 上 不 需要 考虑 互 斥 
和 串 行 化 等 问题 。 */ 
for( ;; ) 


{ 







































































/* 等 待 信息 到 达 。 指 定 了 一 个 无 限 长 阻塞 超时 时 间 ， 所 以 不 需要 检查 返回 值 - 此 函数 只 会 在 成 功 收 到 
消息 时 才 会 返回 。 */ 


xQueueReceive( xPrintQueue, &pcMessageToPrint, portMAX DELAY ); 














/* 输出 收 到 的 字符 串 。 / 
printf( "%s", pcMessageToPrint ); 


fflush( stdout ); 


/* Now simply go back to wait for the next message. */ 


程序 清单 70 ”守护 任务 
害 息 输出 任务 与 例 15 相似 ， 不 同 的 是 本 例 中 字符 串 是 通过 队列 发 送 到 守护 任务 ， 
而 不 是 直接 输出 到 终端 。 具体 实现 参见 程序 清单 71。 和 之 前 一 样 ， 为 这 个 任务 创建 了 
两 个 独立 的 实例 ， 每 个 实例 输出 各 自从 任务 入 口 参数 传 入 的 字符 串 。 


static void prvPrintTask( void *pvParameters ) 


{ 


int iIndexToString; 











/* Two instances of this task are created. The task parameter is used to pass 


an index into an array of strings into the task. Cast this to the required type. */ 














iIndexToString = ( int ) pvParameters; 
for( 7; ) 
{ 
/* 打印 输出 字符 串 ， 不 能 直接 输出 ， 通 过 队列 将 字符 串 指针 发 送 到 守护 任务 。 队 列 在 调度 器 启动 之 前 就 




















创建 了 ， 所 以 任务 执行 时 队列 就 已 经 存在 了 。 并 有 指定 超时 等 待 时 间 ， 因 为 队列 空间 总 是 有 效 。 */ 


xQueueSendToBack( xPrintQueue, &( pcStringsToPrint[ ilndexToString ] ), 0 ); 


























/* 等 待 一 个 伪 随 机 时 间 。 注 意 函数 rand O 不 要 求 可 重 入 ， 因 为 在 本 例 中 rand () 的 返回 值 并 不 重要 。 但 
在 安全 性 要 求 更 高 的 应 用 程序 中 ， 需 要 用 一 个 可 重 入 版 本 的 rand () 函数 - 或 是 在 临界 区 中 调用 rand () 
函数 。 */ 

vTaskDelay( ( rand() & OxlFF ) ) 









































程序 清单 71 例 16 中 的 打印 输出 任务 实现 代码 
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心跳 钩子 函数 仅仅 是 简单 地 对 其 被 调用 次 数 进行 计数 ， 当 计数 全 200 时 就 向 守护 
任务 发 送信 息 。 为 了 具有 更 好 的 演示 效果 ， 心 跳 钩子 函数 将 信息 发 送 到 队列 首 ， 而 打印 
输出 任务 将 信息 发 送 到 队列 尾 。 心 跳 钩子 函数 的 实现 代码 如 程序 清单 72 所 示 。 

















void vApplicationTickHook( void ) 
static int iCount = 0; 


portBASE TYPE xHigherPriorityTaskWoken = pdFALSE; 


/* Print out a message every 200 ticks. The message is not written out 
directly, but sent to the gatekeeper task. */ 
iCount++; 
if( iCount >= 200 ) 
{ 
/* In this case the last parameter (xHigherPriorityTaskWoken) is not 
actually used but must still be supplied. */ 
xQueueSendToFrontFromISR( xPrintQueue, 
&( pcStringsToPrint[ 2 ] ), 


&xHigherPriorityTaskWoken ); 
/* Reset the count ready to print out the string again in 200 ticks 


time. */ 


iCount = 0; 


程序 清单 72 ”心跳 钩子 函数 实现 代码 





和 往常 一 样 ，main() 函 数 创建 队列 和 所 有 任务 ， 然 后 启动 调度 器 。main() 函 数 的 具 
体 实现 参见 程序 清单 73。 
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/* 定义 任务 和 中 断 将 会 通过 守护 任务 输出 的 : 
static char *pcStringsToPrint[] = 


{ 





Em 
一 人、 

3 
Lm 
Ud 


4 


"Task 1 HK KKK KKK RRR e he he KKK KK e e e dede he he KKK e e e e e de de je ke je ke ke eee kN PN DM, 








/* 声明 xQueueHandle 变 量 。 这 个 变量 将 会 用 于 打印 任务 和 中 断 往 守护 任务 发 送 消 息 。*/ 


xQueueHandle xPrintQueue; 








int main( void ) 


{ 
/* 创建 队列 ， 深 度 为 5， 数 据 单元 类 型 为 字符 指针 。 */ 


xPrintQueue = xQueueCreate( 5, sizeof( char * ) ); 








/* 为 伪 随 机 数 发 生 器 产生 种 子 。 */ 
srand( 567 ) 


/* Check the queue was created successfully. */ 
if( xPrintQueue !- NULL ) 


( 








/* 创建 任务 的 两 个 实例 ， 用 于 向 守护 任务 发 送信 息 。 任 务 入 口 参数 传 入 需要 输出 的 字符 串 索 引号 。 这 两 
































个 任务 具有 不 同 的 优先 级 ， 所 以 高 优先 级 任务 有 时 会 抢占 低 优先 级 任务 。 */ 
xTaskCreate( prvPrintTask, "Printl", 1000, ( void * ) 0, 1, NULL 
xTaskCreate( prvPrintTask, "Print2", 1000, ( void * ) 1, 2, NULL 








/* 创建 守护 任务 。 这 是 唯一 一 个 允许 直接 访问 标准 输出 的 任务 。 / 
xTaskCreate( prvStdioGatekeeperTask, "Gatekeeper", 1000, NULL, 0, 











/* Start the scheduler so the created tasks start executing. */ 


vTaskStartScheduler () ; 

















/* 如 果 一 切 正 常 ，main () 函数 不 会 执行 到 这 里 ， 因 为 调度 器 已 经 开始 运行 任务 。 但 如 果 程 序 
很 可 能 是 由 于 系统 内 存 不 足 而 无 法 创建 空闲 任务 。 第 五 章 会 提供 更 多 关于 内 存 管理 的 信息 */ 


for( ;; ); 

















程序 清单 73 例 16 中 的 main() 函 数 实现 代码 
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); 
js? 


NULL ); 


运行 到 了 这 里 ， 
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图 41 展现 了 例 16 的 运行 输出 结果 。 从 图 中 可 以 看 到 ， 无 念经 是 来 自任 务 的 学 符 


串 还 是 来 自 中 断 的 字符 中 都 被 正确 地 打印 输出 ， 没 有 出 现 数据 破坏 。 
mowS evstem2 seme exe = rtosdem = -iix 


Message printed from the tick hook interrupt HHHHHHHHHHHHHE 
Message printed from the tick hook interrupt HHHH HHHH 

















Message printed from the tick hook interrupt 1HHEHEHETHEHHHHIHI 


Task 1 soetx xx «2C CC ROC ICE EE IE JE MCCC JE PE JE E JE REC JEJE PE JE JE JE PE JE IE JE MEJE PE JEE DE CC 


Message printed from the tick hook interrupt H#H#HHHHHHHHHHHH 
k 2 

Message printed from the ck hook interrupt HHHHHHHHHHHHHH 
2 


Message printed from the tick hook interrupt HHHHHHHHHHHHHE 

Message printed from the tick hook interrupt 1HHHEEEHEHHHHHHE 

Task 2 

Task 1 3€-3€E3€E3€3€3€3E39E 9E 9E 9E 9E 9E EE ECCE EE EE 9E 399 9E 9E 9E 9E ECCE ECCE ECCE EE 9E 9E 9E 0E CC 

Message printed from the tick hook interrupt I31HHHEHEHEHEHHHI 
sk 2 


Message printed from the tick hook interrupt HHHHHHHHHHHHHE 











图 41 例 16 的 运行 输出 结 
守护 任务 的 优先 级 低 于 打印 任务 一 一 所 以 发 送 到 守护 任务 的 消息 会 一 直 保 持 在 队 
列 中 ， 直 到 两 个 打印 任务 都 进入 阻塞 态 。 在 一 些 情况 下 ,需要 给 守护 任务 赋予 一 个 较 高 
的 优先 级 , 消息 就 可 以 得 到 更 快 的 处 理 一 一 但 这 样 做 会 由 于 守护 任务 的 开销 使 得 低 优先 
级 任务 被 推迟 ， 直 到 和 守护 任务 完成 对 受 其 保护 的 资源 的 访问 。 
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5.1 概览 






































每 当 任务 ， 队 列 或 是 信号 量 被 创建 时 ， 内 核 需要 进行 动态 内 存 分 配 。 虽 然 可 以 调用 
标准 的 malloc() free() 库 函数 ， 但 必须 承担 以 下 若干 问题 : 











这 两 个 函数 在 小 型 嵌入 式 系统 中 可 能 不 可 用 。 
两 个 函数 的 具体 实现 可 能 会 相对 较 大 ， 会 占用 较 多 宝贵 的 代码 空间 。 
两 个 函数 通常 不 具备 线程 安全 特性 。 

两 个 函数 具有 不 确定 性 。 每 次 调用 时 的 时 间 开 销 都 可 能 不 同 

两 个 函数 会 产生 内 存 碎片 。 

两 个 函数 会 使 得 链接 器 配置 得 复杂 。 












































b oc xxx 














AR [EL HON CR EFC AI AKAA AE TREES «rr DPF YE BUSES n] 
能 适合 部 分 应 用 程序 。 因 此 ，FreeRTOS 将 内 存 分 配 作为 可 移植 层面 (相对 于 基本 的 内 
核 代码 部 分 而 言 )。 这 使 得 不 同 的 应 用 程序 可 以 提供 适合 自身 的 具体 实现 。 

当 内 核 请 求 内 存 时 ， 其 调用 pvPortMalloc() 而 不 是 直接 调用 malloc(); 当 释 放 内 存 
时 ， 调 用 vPortFree() 而 不 是 直接 调用 free()。pvPortMalloc() 具 有 与 malloc() 相 同 的 函 
数 原型 ，vPortFree() 也 具有 与 free() 相 同 的 函数 原型 。 

FreeRTOS 自 带 有 三 种 pvPortMalloc() 与 vPortFree() 实 现 范例 , 这 三 种 方式 都 会 在 
本 章 描述 。FreeRTOS 的 用 户 可 以 选用 其 中 一 种 ， 也 可 以 采用 自己 的 内 存 管 理 方式 。 

这 三 个 范例 对 应 三 个 源 文件 ， heap_1.c，heap_2.c，heap_3.c 一 一 这 三 个 文件 都 
放 在 目录 FreeRTOS\Source\Portable\MemMang 中 。 早 期 版 本 的 FreeRTOS 所 采用 的 
原始 内 存 池 和 内 存 块 分 配方 案 已 经 被 移 除 了 , 因为 定义 内 存 块 和 内 存 池 的 大 小 需要 较 深 
入 的 努力 和 理解 。 

在 小 型 骨 入 式 系统 中 ,通常 是 在 启动 调度 器 之 前 创建 任务 ， 队 列 和 信号 量 。 这 种 情 
况 表明 , 动态 分 配 内 存 只 会 出 现在 应 用 程序 真正 开始 执行 实时 功能 之 前 , 而 且 内 存 一 旦 
分 配 就 不 会 再 释放 。 这 就 意味 着 选择 内 存 分 配方 案 时 不 必 考 虑 一 些 复杂 的 因素 ， 比 如 确 
定性 与 内 存 碎片 等 ， 而 具 需 要 从 性 能 上 考虑 ， 比 如 代码 大 小 和 简易 性 。 
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本 章 期 望 让 读者 了 解 以 下 事情 : 
e FreeRTOS 在 什么 时 候 分 配 内 存 。 
e FreeRTOS 提供 的 三 种 内 存 分 配方 案 范 例 。 












































FreeRTOS 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


122 


http://www.FreeRTOS.org 


5.2 内 存 分 配方 案 范例 


Heap 1.c 
Heap 1.c 实现 了 一 个 非常 基本 的 pvPortMalloc() 版 本 , 而 且 没 有 实现 vPortFree(). 
如 果 应 用 程序 不 需要 删除 任务 , 队列 或 者 信号 量 , 则 具有 使 用 heap 1 的 潜质 。 Heap_1 
总 是 具有 确定 性 。 
这 种 分 配方 案 是 将 FreeRTOS 的 内 存 堆 空 间 看 作 一 个 简单 的 数组 。 当 调用 
pvPortMalloc() 时 ， 则 将 数组 又 简单 地 细 分 为 更 小 的 内 存 块 。 
数组 的 总 大 小 ( 字 节 为 单位 ) 在 FreeRTOSConfig.h 中 由 configTOTAL _HEAP_SIZE 
定义 。 以 这 种 方式 定义 一 个 巨型 数组 会 让 整个 应 用 程序 看 起 来 耗费 了 许多 内 存 一 一 即使 
是 在 数组 没有 进行 任何 实际 分 配 之 前 。 
需要 为 每 个 创建 的 任务 在 堆 空 间 上 分 配 一 个 任务 控制 块 (TCB) 和 一 个 栈 空间 ,图 42 
展示 了 heap 1 是 如 何在 任务 创建 时 细 分 这 个 简单 数组 的 。 从 图 42 中 可 以 看 到 : 
。 A 表示 数组 在 没有 任何 任务 创建 时 的 情形 ， 这 里 整个 数据 是 空 的 。 
。B 表示 数组 在 创建 了 一 个 任务 后 的 情形 。 
。C 表示 数组 在 创建 了 三 个 任务 后 的 情形 。 
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图 42 每 次 创建 任务 后 的 内 存 分 配 情况 
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Heap_2.c 





Heap 2.c 也 是 使 用 了 一 个 由 configTOTAL_HEAP_ SIZE 定义 大 小 的 简单 数组 。 不 
同 于 heap 1 的 是 ，heap_2 采用 了 一 个 最 佳 匹配 算法 来 分 配 内 存 ,并 且 支 持 内 存 释 放 。 
由 于 声明 了 一 个 静态 数组 , 所 以 会 让 整个 应 用 程序 看 起 来 耗费 了 许多 内 存 一 一 即使 是 在 
数组 没有 进行 任何 实际 分 配 之 前 。 

最 佳 匹 配 算法 保证 pvPortMalloc() 会 使 用 最 接近 请 求 大 小 的 空闲 内 存 块 。 比 如 ， 考 
虑 以 下 情形 : 

1， 堆 空间 中 包含 了 三 个 空闲 内 存 块 ， 分 别 为 5 字 节 ，25 字 节 和 100 X^. 

2. pvPortMalloc() 被 调用 以 请 求 分 配 20 字 节 大 小 的 内 存 空间 。 
匹配 请 求 字 节 数 的 最 小 空 闪 内 存 块 是 具有 25 字 节 大 小 的 内 存 块 一 一 所 以 pvPortMalloc() 
会 将 这 个 25 字 节 块 再 分 为 一 个 20 字 节 块 和 一 个 5 字 节 块 3， 然 后 返回 一 个 指向 20 字 
节 块 的 指针 。 剩 下 的 5 字 节 块 则 保留 下 来 ， 留 待 以 后 调用 pvPortMalloc() 时 使 用 。 

Heap 2.c 并 不 会 把 相 邻 的 空闲 块 合并 成 一 个 更 大 的 内 存 块 ， 所 以 会 产生 内 存 碎 
一 一 如 果 分 配 和 释放 的 总 是 相同 大 小 的 内 存 块 ， 则 内 存 碎片 就 不 会 成 为 一 个 问题 。 
Heap 2.c 适合 用 于 那些 重复 创建 与 删除 具有 相同 栈 空间 任务 的 应 用 程序 。 
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图 43 创建 和 删除 任务 后 的 内 存 分 配 情况 











“这 是 过 于 简化 。 因 为 heap_2 会 在 堆 中 保存 一 些 信息 ， 所 以 两 个 分 离 的 内 存 块 总 量 会 小 于 25 
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图 43 展示 了 当 任务 创建 ， 删 除 以 及 再 创建 过 程 中 ， 最 佳 匹 配 算法 是 如 何 工作 的 。 
从 图 43 中 可 以 看 出 : 





。A 表示 数组 在 创建 了 三 个 任务 后 的 情形 。 数 组 的 顶部 还 剩余 一 个 大 空闲 块 。 





。B 表示 数组 在 删除 了 一 个 任务 后 的 情形 。 顶 部 的 大 空闲 块 保持 不 变 , 并 多 出 了 两 
个 小 的 空闲 块 ， 分 别 是 被 删除 任务 的 TCB 和 任务 栈 。 








。C 表示 数组 在 又 创建 了 一 个 任务 后 的 情形 。 创 建 一 个 任务 会 产生 两 次 调用 
pvPortMalloc()， 一 次 是 分 配 TCB， 一 次 是 分 配 任务 栈 (调用 pvPortMalloc() 发 
生 在 xTaskCreate() API 函数 内 部 )。 




















每 个 TCB 都 具有 相同 大 小 ， 所 以 最 佳 匹 配 算法 可 以 确保 之 前 被 删除 的 任务 占 
用 的 TCB 空间 被 重新 分 配 用 作 新 任务 的 TCB 空间 。 





















































浙 建 任务 的 栈 空间 与 之 前 被 删除 任务 的 栈 空间 大 小 相同 , 所 以 最 佳 匹配 算法 会 
保证 之 前 被 删除 任务 占用 的 栈 空间 会 被 重新 分 配 用 作 新 任务 的 栈 空间 。 














数组 顶部 的 大 空闲 块 依然 保持 不 变 。 

















Heap 2.c 虽然 不 具备 确定 性 ， 但 是 比 大 多 数 标准 库 实 现 的 malloc() 与 free() 更 有 效率 。 
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Heap_3.c 

Heap 3.c 简单 地 调用 了 标准 库 函 数 malloc() All free(), 但 是 通过 和 暂时 挂 起 调度 器 使 
得 函数 调用 备 线程 安全 特性 。 其 实现 代码 参见 程序 清单 74。 

此 时 的 内 存 扒 空间 大 小 不 受 configTOTAL HEAP SIZE 影响 ， 而 是 由 链接 器 配置 














void *pvPortMalloc( size t xWantedSize ) 


{ 


void *pvReturn; 
vTaskSuspendA11(); 


( 


pvReturn - malloc( xWantedSize ); 


) 


xTaskResumeAll(); 


return pvReturn; 


void vPortFree( void *pv ) 





{ 
if( pv != NULL ) 
{ 
vTaskSuspendA11() ; 
free( pv ); 
} 
xTaskResumeAl11 () ; 
} 
} 
程序 清单 74 heap 3.c 实现 代码 
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6.1 概览 








本 章 主 要 是 为 刚 接触 FreeRTOS 的 用 户 指 出 那些 新 手 通常 容易 遇 到 的 问题 。 这 里 
把 最 主要 的 篇 幅 放 在 栈 溢 出 以 及 栈 溢出 侦 测 上 , 因为 栈 相关 的 问题 是 过 去 几 年 遇 到 最 多 
的 问题 。 对 其 它 一 些 比较 常见 的 问题 本章 简要 的 以 FAQ( 问 答 ) 的 形式 给 出 可 能 的 原因 
和 解决 方法 。 
































printf-stdarg.c 

当 调 用 标准 C. 库 函 数 时 ， 栈 空间 使 用 量 可 能 会 急剧 上 升 ， 特 别 是 IO 与 字符 串 处 理 
函数 ， 比 如 sprintf()。 在 FreeRTOS 下 载 包 中 有 一 个 名 为 printf-stdarg.c 的 文件 。 这 个 
文件 实现 了 一 个 栈 效 率 优化 版 的 小 型 sprintf()， 可 以 用 来 代替 标准 C 库 函 数 版 本 。 在 大 
多 数 情况 下 , 这 样 做 可 以 使 得 调用 sprintf() 及 相关 函数 的 任务 对 栈 空间 的 需求 量 小 很 多 。 












































printf-stdarg.c 源 代码 开放 ， 但 是 为 第 三 方 所 有 。 所 以 此 源 代码 的 license 独立 于 
FreeRTOS。 具 体 的 license 条 款 包含 在 该 源 文 件 的 起 始 部 分 。 
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6.2 栈 溢出 


FreeRTOS 提供 了 多 种 特性 来 辅助 跟踪 调试 栈 相关 的 问题 “。 


uxTaskGetStackHighWaterMark() API 函数 


每 个 任务 都 独立 维护 自己 的 栈 空间 








， 栈 空间 总 量 在 任务 创建 时 进行 设 定 。 





uxTaskGetStackHighWaterMark() 主 要 用 来 查询 指定 任务 的 运行 历史 中 , 其 栈 空间 还 差 
多 少 就 要 洲 出 。 这 个 值 被 称 为 栈 空间 的 "高 水 线 (High Water Mark)”. 











unsigned portBASE TYPE uxTaskGetStackHighWaterMark( xTaskHandle xTask ); 


程序 清单 75  uxTaskGetStackHighWaterMark() API 函数 原型 


K 20 uxTaskGetStackHighWaterMark() 参 数 与 返回 值 


























参数 名 描述 
xTask 被 查询 任务 的 句柄 一 一 欲 知 如 何 获得 任务 句柄 , 详情 请 参见 API 函数 
xTaskCreate() 的 参数 pxCreatedTask。 
如 果 传 入 NULL 句柄 ， 则 任务 碍 询 的 是 自身 栈 空间 的 高 水 线 。 
返回 值 任务 栈 空间 的 实际 使 用 量 会 随 着 任务 执行 和 中 断 处 理 过 程 上 下 浮动 。 








uxTaskGetStackHighWaterMark() 返 回 从 任务 启动 执行 开始 的 运行 
历史 中 ， 栈 空间 具有 的 最 小 剩余 量 。 这 个 值 即 是 栈 空间 使 用 达到 最 深 
时 的 剩 下 的 未 使 用 的 栈 空间 。 这 个 值 越 是 接近 0， 则 这 个 任务 就 越 是 








离 栈 溢出 不 远 了 。 





























“不 幸 的 是 ， 这 些 特性 无 法 在 一 个 模拟 的 DOS 环境 下 使 用 ， 因 为 DOS 采用 的 是 段 式 内 存 。 因 此 无 


法 在 Open Watcom 上 的 示范 这 些 特性 的 使 用 方法 。 
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运行 时 栈 侦 测 一 一 概述 

FreeRTOS 包含 两 种 运行 时 栈 侦 测 机 制 ， 由 FreeRTOSConfig.h 中 的 配置 常 
configCHECK FOR. STACK OVERFLOW 进行 控制 。 这 两 种 方式 都 会 增加 上 下 切换 
开销 。 

栈 溢 出 钓 子 函数 (或 称 回调 函数 ) 由 内 核 在 侦 测 到 栈 溢出 时 调用 。 要 使 用 栈 溢出 钓 子 
函数 ， 需 要 进行 以 下 配置 : 
。 在 FreeRTOSConfig.h 中 把 configcHECK FOR STACK OVERFLOW 设 为 1 或 2。 
。 提 供 钧 子 函 数 的 具体 实现 ， 采 用 程序 清单 76 所 示 的 函数 名 和 函数 原型 。 














zi 









































void vApplicationStackOverflowHook ( xTaskHandle *pxTask, signed portCHAR *pcTaskName ) ; 


程序 清单 76 ” 栈 溢 出 钩子 函数 原型 














栈 溢出 钧 子 函数 只 是 为 了 使 跟踪 调试 栈 空 间 错误 更 容易 , 而 无 法 在 栈 溢出 时 对 其 进 
行 恢复 。 函 数 的 入 口 参数 传 入 了 任务 句柄 和 任务 名 , 但 任务 名 很 可 能 在 溢出 时 已 经 遭 到 
破坏 。 

栈 洪 出 钧 子 函数 还 可 以 在 中 断 的 上 下 文中 进行 调用 。 

某 些 微 控 制 器 在 检测 到 内 存 访问 错误 时 会 产生 错误 异常 , 很 可 能 在 内 核 调用 栈 溢 出 
钩子 函数 之 前 就 触发 了 错误 异常 中 断 。 











运行 时 栈 侦 测 —— 方法 1 

当 configCHECK_FOR_STACK_OVERFLOW 设置 为 1 时 选用 方法 1。 

任务 被 交换 出 去 的 时 候 ， 该 任务 的 整个 上 下 文 被 保存 到 它 自 己 的 栈 空 间 中 。 这 时 任 
务 栈 的 使 用 应 当 达到 了 一 个 峰值 。 当 configCHECK_FOR_STACK_OVERFLOW 设 为 
1 时 ， 内 核 会 在 任务 上 下 文保 存 后 检查 栈 指 针 是 否 还 指向 有 效 栈 空间 。 一 旦 检测 到 栈 指 
针 的 指 加 已 经 超出 任务 栈 的 有 效 范围 ， 栈 溢出 钧 子 函数 就 会 被 调用 。 





























方法 1 具有 较 快 的 执行 速度 , 但 栈 溢 出 有 可 能 发 生 在 两 次 上 下 文保 存 之 间 , 这 种 情 
况 不 会 被 侦 测 到 。 
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运行 时 栈 侦 测 一 一 方法 2 

将 configCHECK_FOR_STACK_OVERFLOW 设 为 2 就 可 以 选用 方法 2。 方 法 2 
在 方法 1 的 基础 上 进行 了 一 些 补充 。 

当 创建 任务 时 ， 任 务 栈 空间 中 就 预 置 了 一 个 标记 。 方 法 2 会 检查 任务 栈 的 最 后 20 
个 字 节 ， 碍 看 预 置 在 这 里 的 标记 数据 是 否 被 覆盖 。 如 果 最 后 20 个 学 节 的 标记 数据 与 预 
设 值 不 同 ， 则 栈 溢出 钧 子 函 数 就 会 被 调用 。 

方法 2 没有 方法 1 的 执行 速度 快 ， 但 测试 仅仅 20 个 字 节 相对 来 说 也 是 很 快 的 。 这 
种 方法 应 该 可 以 侦 测 到 任何 时 候 发 生 的 栈 溢出 ， 虽 然 理 论 上 还 是 有 可 能 漏 掉 一 些 情况 ， 
但 这 些 情 况 几乎 是 不 可 能 发 生 的 。 
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6.3 其 它 常 见 错误 


问题 现象 : 在 一 个 Demo 应 用 程序 中 增加 了 一 个 简单 的 任务 ， 导 致 应 用 程序 崩 淡 
任务 创建 时 需要 在 内 存 堆 中 分 配 空间 。 许 多 Demo 应 用 程序 定义 的 堆 空间 大 小 只 
够 用 于 创建 Demo 任务 一 一 所 以 当 任 务 创建 完成 后 ， 就 没有 足够 的 剩余 空间 来 增加 其 
它 的 任务 ， 队 列 或 信号 量 。 
空闲 任务 是 在 vTaskStartScheduler() 调 用 中 自动 创建 的 。 如 果 由 于 内 存 不 足 而 无 
法 创建 空 闪 任务，vTaskStartScheduler() 会 直接 返回 。 在 调用 vTaskStartScheduler() 
后 加 上 一 条 空 循环 [for(;;)] 可 以 使 这 种 错误 更 加 容易 调试 。 
如 果 要 添加 更 多 的 任务 ,可 以 增加 内 存 堆 空间 大 小 , 或 是 删 掉 一 些 已 存在 的 Demo 


任务 。 










































































问题 现象 : 在 中 断 中 调用 一 个 API 函数 ， 导 致 应 用 程序 崩溃 
除了 具有 后 级 为 "FromlSR” 函 数 名 的 API 函数 , 和 干 万 不 要 在 中 断 服务 例 程 中 调用 其 
它 API 函数 。 








问题 现象 : 有 时 候 应 用 程序 会 在 中 断 服务 例 程 中 裔 省 

需要 做 的 第 一 件 事 是 检查 中 断 是 否 导 致 了 栈 溢 出 。 

在 不 同 的 移植 平台 和 不 同 的 编译 器 上 , 中 断 的 定义 和 使 用 方法 是 不 尽 相同 的 一 一 所 
以 ， 需 要 做 的 第 二 件 事 是 检查 在 中 断 服务 例 程 中 使 用 的 语法 ， 宏 和 调用 约定 是 否 符合 
Demo 程序 的 文档 描述 ， 以 及 是 否 和 Demp 程序 中 提供 的 中 断 服 务 例 程 范例 相同 。 

如 果 应 用 程序 工作 在 Cotex M3 上 ， 需 要 确定 给 中 断 指派 优先 级 时 ， 使 用 低 优 先 级 
号 数值 表示 逻辑 上 的 高 优先 级 中 断 ， 因 为 这 种 方式 不 太 直观 ， 所 以 很 容易 被 态 记 。 一 个 
比较 常见 的 错误 就 是 ， 在 优先 级 高 于 configMAX SYSCALL INTERRUPT PRIORITY 
的 中 断 中 调用 了 FreeRTOS API 函数 。 
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问题 现象 : 在 启动 第 一 个 任务 时 ， 调 度 器 就 月 溃 了 
如 果 使 用 的 是 ARM7， 那 么 请 确定 调用 vTaskStartScheduler() 时 处 理 器 处 于 管理 
模式 (Supervisor mode)。 最 入 单 的 方式 就 是 在 main() 之 前 的 C 启动 态 码 中 将 处 理 器 设 
为 管理 模式 。ARM7 的 Demo 应 用 程序 就 是 这 么 做 的 。 
如 果 处 理 器 不 在 管理 模式 下 ， 调 度 器 是 无 法 局 动 的 。 
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问题 现象 : MARKIE EARKE 

除了 taskENTER_CRITICA() 和 taskEXIT_CRITICAL(), 千 万 不 要 在 其 它 地 方 修改 
控制 器 的 中 断 使 能 位 或 优先 级 标志 。 这 两 个 宏 维护 了 一 个 骨 套 深度 计数 ， 所 以 具有 当 所 
有 的 风 套 调用 都 退出 后 计数 值 才 会 为 0， 也 才 会 使 能 中 断 。 




















问题 现象 .在 调度 器 启动 前 应 用 程序 就 骨 演 了 
如 果 一 个 中 断 会 产生 上 下 文 切换 ， 则 这 个 中 断 不 能 在 调度 器 启动 之 前 使 能 。 这 同样 
适用 于 那些 需要 读 写 队列 或 信号 量 的 中 断 。 在 调度 器 启动 之 前 ， 不 能 进行 上 下 文 切 换 。 
还 有 一 些 API 函数 不 能 在 调度 器 启动 之 前 调用 。 在 调用 vTaskStartScheduler() 之 
前 ， 最 好 是 限定 只 使 用 创建 任务 ， 队 列 和 信和 号 量 的 API 函数 。 
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问题 现象 : 在 调度 器 挂 起 时 调用 API REX, FUAT BED 
调用 vTaskSuspendAll() 使 得 调度 器 挂 起 ， 而 唤醒 调度 器 调用 xTaskResumeAlll(). 
千 万 不 要 在 调度 器 挂 起 时 调用 其 它 API 函数 。 








问题 现象 .函数 原型 pxPortlnitialiseStack() 导 致 编译 失败 

每 种 移植 都 需要 定义 一 个 对 应 的 安 ， 以 把 正确 的 内 核 头 文件 加 入 到 工程 中 。 如 果 编 
译 函 数 原型 pxPortlnitialiseStack() 时 出 错 , 这 种 现象 基本 上 可 以 确定 是 因为 没有 正确 定 
义 相 应 的 宏 。 请 参见 附录 4 以 获得 更 多 信息 。 

可 以 基本 相应 平台 的 Demo 工程 建立 新 的 应 用 程序 。 这 种 方式 就 不 用 担心 没有 包 
含 正 确 的 文件 ， 也 不 必 担 心 没有 正确 地 配置 编译 器 选项 。 
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APPENDIX 1: BUILDING THE EXAMPLES 


This book presents numerous examples — the source code for which is provided in an accompanying 
.zip file along with project files that can be opened and built from within the free Open Watcom IDE. 
The resultant executables can then be executed either within a Windows command terminal or 
alternatively under the free DOSBox DOS emulator. See http://www.openwatcom.org and 
http://www.dosbox.com for tool downloads. 


Ensure to include the 16bit DOS target options when installing the Open Watcom compiler! 


The Open Watcom project files are all caled RTOSDemo.wpj and can be located in the 
Examples\ExampleOnn directories, where ‘nn’ is the example number. 


DOS is far from an ideal target for FreeRTOS and the example applications will not run with true real 
time characteristics. DOS is used simply because it allows users to experiment with the examples 
without first having to invest in specialist hardware or tools. 


Please note the Open Watcom debugger will allow interrupts to execute between step operations — 
even when stepping through code that is within a critical section. This unfortunately makes it 
impossible to step through the context switch process. 


It is best to run the generated executables from a command prompt rather than from within the Open 
Watcom IDE. 


FreeRTOS 135 
Designed For Microcontrollers; 
© 2009 Richard Barry. Distribution or publication in any form is strictly prohibited. 


http://www.FreeRTOS.org 





APPENDIX 2: THE DEMO APPLICATIONS 


Each official FreeRTOS port comes with a demo application that should build without any errors or 
warnings being generated?. The demo application has several purposes: 


1. 


2. 


3. 


4. 


To provide an example of a working and pre-configured project with the correct files 
included and the correct compiler options set. 


To allow 'out of the box' experimentation with minimal setup or prior knowledge. 
To demonstrate the FreeRTOS API. 


As a base from which real applications can be created. 


Each demo project is located in a unique directory under the Demo directory (see APPENDIX 3: ). 
The directory name will indicate the port that the demo project relates to. 


Every demo application also comes with a documentation page that is hosted on the FreeRTOS.org 
WEB site. The documentation page includes information on locating individual demo applications in 
FreeRTOS directory structure. 


All the demo projects create tasks that are defined in source files that are located in the 
Demo\Common directory tree. Most use files from the Demo\Common\Minimal directory. 


A file called main.c is included in each project. This contains the main() function, from where all the 
demo application tasks are created. See the comments within the individual main.c files for more 
information on what a specific demo application does. 





? This is the ideal scenario, and is normally the case, but is dependent on the version of the compiler being used 
to build the demo. Upgraded compilers can sometimes generate warnings where their predecessors didn't. 
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Figure 44 Locating the demo application documentation in the menu frame of the FreeRTOS.org WEB 
site 
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APPENDIX 3: FREERTOS FILES AND DIRECTORIES 


The directory structure described in this appendix relates only to the .zip file that can be downloaded 
from the FreeRTOS.org WEB site. The examples that come with this book use a slightly different 
organization. 


FreeRTOS is downloaded as a single .zip file that contains: 
e The core FreeRTOS source code. This is the code that is common to all ports. 
e A port layer for each microcontroller and compiler combination that is supported. 


e A project file or makefile to build a demo application for each microcontroller and 
compiler combination that is supported. 


e A set of demo tasks that are common to each demo application. These demo tasks are 
referenced from the port specific demo projects. 


The zip file has two top level directories, one called Source and the other called Demo. The Source 
directory tree contains the entire FreeRTOS kernel implementation — both the common components 
and the port specific components. The Demo directory tree contains just the demo application project 
files and the source files that define the demo tasks. 


FreeRTOS 
| 
+-Demo Contains the demo application source and projects. 
| 
| 
+-Source Contains the implementation of the real time kernel. 


Figure 45 The top level directories - Source and Demo 


The core FreeRTOS source code is contained in just three C files that are common to all the 
microcontroller ports. These are called queue.c, tasks.c and list.c, and can be located directly under 
the Source directory. The port specific files are located within the Portable directory tree, which is also 
located directly within the Source directory. 


A fourth optional source file called croutine.c implements the FreeRTOS co-routine functionality. It 
only needs to be included in the build if co-routines are actually going to be used. 
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FreeRTOS 
| 
| 
+-Demo Contains the demo application source and projects. 
| 
+-Source Contains the implementation of the real time kernel. 


| 

+-tasks.c One of the three core kernel files. 

+-queue.c One of the three core kernel files. 

+-list.c One of the three core kernel files. 

+-portable The sub-directory that contains all the port specific files. 


Figure 46 The three core files that implement the FreeRTOS kernel 


Removing Unused Files 


The main FreeRTOS .zip file includes the files for all the ports and all the demo applications so 
contains many more files than are required to use any one port. The demo application project or 
makefile that accompanies the port being used can be used as a reference to which files are required 
and which can be deleted. 


The ‘portable layer’ is the code that tailors the FreeRTOS kernel to a particular compiler and 
architecture. The portable layer source files are located within the 
FreeRTOS\Source\Portable\[compiler]\[architecture] directory, where [compiler] is the tool chain being 
used and [architecture] is the microcontroller variant being used. 


e All the sub-directories under FreeRTOS\Source\Portable that do not relate to the tool chain 
being used can be deleted except the directory FreeRTOS\Source\Portable\MemMang. 


e All the sub-directories under FreeRTOS\Source\Portable\[compiler] that do not relate to the 
microcontroller variant being used can be deleted. 


e All the sub-directories under FreeRTOS\Demo that do not relate to the demo application being 
used can be deleted except the FreeRTOS\Demo\Common directory, which contains files that 
are referenced from all the demo applications. 


FreeRTOS\Demo\Common contains many more files than are referenced from any one demo 
application so this directory can also be thinned out if desired. 
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APPENDIX 4: CREATING A FREERTOS PROJECT 


Adapting One of the Supplied Demo Projects 


Every official FreeRTOS port comes with a pre-configured demo application that should build without 
any errors or warnings (see APPENDIX 2: ). It is recommended that new projects are created by 
adapting one of these existing projects. This way the project will include the correct files and have the 
correct compiler options set. 


To start a new application from an existing demo project: 
1. Open up the supplied demo project and ensure it builds and executes as expected. 


2. Strip out the source files that define the demo tasks. Any file that is located within the 
Demo\Common directory tree can be removed from the project file or makefile. 


3. Delete all the functions within main.c other than prvSetupHardware(). 


4. Ensure configUSE IDLE HOOK, configUSE TICK HOOK and 
configCHECK FOR STACK OVERFLOW are all set to 0 within FreeRTOSConfig.h. This will 
prevent the linker looking for any hook functions. Hook functions can be added later if 
required. 


5. Create a new main() function from the template shown in Listing 77. 
6. Check that the project still builds. 


Following these steps will provide a project that includes the FreeRTOS source files but does not 
define any functionality. 
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int main( void ) 


{ 


/* Perform any hardware setup necessary. */ 


prvSetupHardware () ; 


/* --- APPLICATION TASKS CAN BE CREATED HERE --- */ 


/* Start the created tasks running. */ 


vTaskStartScheduler () ; 


/* Execution will only reach here if there was insufficient heap to 
start the scheduler. */ 

for( ;; ); 

return 0; 


Listing 77 The template for a new main() function 


Creating a New Project from Scratch 


As just mentioned, it is recommended that new projects are created from the existing demo projects. 
If for some reason this is not desirable then a new project can be created by using the following steps: 


1. 


2. 


Create a new empty project file or makefile using your chosen tool chain. 
Add the files detailed within Table 21 to the newly created project or makefile. 
Copy an existing FreeRTOSConfig.h file into the project directory. 


Add both the project directory and FreeRTOS\Source\include to the path the project will search 
to locate header files. 


Copy the compiler settings from the relevant demo project or makefile. In particular every port 
requires a macro to be set that ensures the correct kernel header files are included in the build. 
For example, builds targeted at the MegaAVR using the IAR compiler require 
IAR MEGA AVR to be defined, and builds targeted at the ARM Cortex M3 using the GCC 
compiler require GCC ARMCMS3 to be defined. The definitions get used by 
FreeRTOS\Source\include\portable.h — which can be inspected if it is not obvious which 
definition is required. 
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Table 21 FreeRTOS source files to include in the project 
File Location 


tasks.c | FreeRTOS Source 
queue.c FreeRTOS Source 
list.c FreeRTOS\Source 


port.c FreeRTOS\Source\portable\[compiler]\[architecture] where [compiler] is the compiler being 
used and [architecture] is the microcontroller variant being used. 


port.x Some ports also require the project to include an assembly file. The file will be located in 
the same directory as port.c. The file name extension will depend on the tool chain being 
used — x should be replaced with the real file name extension. 


Header Files 


A source file that uses the FreeRTOS API must include *FreeRTOS.h', then the header file that 
contains the prototype for the API function being used — either "task.h", *queue.h" or "semphr.h". 
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APPENDIX 5: DATA TYPES AND CODING STYLE GUIDE 


Data Types 


Each port of FreeRTOS has a unique portable.h header file in which is defined a set of macros that 
detail the data types that are used. All the FreeRTOS source code and demo applications use these 
macro definitions rather than directly using base C data types — but there is absolutely no reason why 
applications that use FreeRTOS need to do the same. Application writers can substitute the real data 
types for each of the macros defined within Table 22. 


Macro or typedef 
used 


portCHAR 
portSHORT 
portLONG 


portTickType 


portBASE, TYPE 


Table 22 Data types used by FreeRTOS 


Actual type 


char 

short 

long 

This is used to store the tick count and specify block times. 

portTickType can be either an unsigned 16bit type or an unsigned 32bit type 
depending on the setting of configUSE 16 BIT TICKS within 
FreeRTOSConfig.h. 

Using a 16bit type can greatly improve efficiency on 8 and 16bit architectures but 
severely limits the range of block times that can specified. It would not make 
sense to use a 16bit type on a 32bit architecture. 

This will be defined to be the most efficient type for the architecture. Typically 
this would be a 32bit type on a 32bit architecture, a 16bit type on a 16bit 
architecture, and an bit type on an 8bit architectures. 


portBASE TYPE is generally used for return types that can only take a very 
limited range of values and for Booleans. 


Some compilers make all unqualified char variables unsigned, while others make them signed. For 
this reason the FreeRTOS source code explicitly qualifies every use of portCHAR with either signed or 


unsigned. 


int types are never used — only long and short. 
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Variable Names 


Variables are pre-fixed with their type. ‘c’ for char, ‘s’ for short, ‘I’ for long and ‘x’ for portBASE_TYPE 
and any other type (structures, task handles, queue handles, etc.). 


If a variable is unsigned it is also prefixed with a ‘u’. If a variable is a pointer it is also prefixed with a 
‘p’. Therefore a variable of type unsigned char will be prefixed with ‘uc’, and a variable of type pointer 
to char will be prefixed ‘pc’. 
Function Names 
Functions are prefixed with both the type they return and the file they are defined within. For example: 
e vTaskPrioritySet() returns a void and is defined within task.c. 
e xQueueReceive() returns a variable of type portBASE TYPE and is defined within queue.c. 
e vSemaphoreCreateBinary() returns a void and is defined within semphr.h. 


File scope (private) functions are prefixed with 'prv'. 


Formatting 


1 tab is always set to equal 4 spaces. 


Macro Names 


Most macros are written in capitals and prefixed with lower case letters that indicate where the macro 
is defined. Table 23 provides a list of prefixes. 
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Table 23 Macro prefixes 
Prefix Location of macro definition 


port (for example, porrMAX DELAY) portable.h 

task (for example, taskENTER_CRITICAL()) task.h 

pd (for example, pdTRUE) projdefs.h 

config (for example, configUSE PREEMPTION) FreeRTOSConfig.h 
err (for example, errQUEUE FULL) projdefs.h 


Note that the semaphore API is written almost entirely as a set of macros but follows the function 
naming convention rather than the macro naming convention. 


The macros defined in Table 24 are used throughout the FreeRTOS source. 


Table 24 Common macro definitions 


Macro Value 
pdTRUE 1 
pdFALSE 0 
pdPASS 1 
pdFAIL 0 


Rationale for Excessive Type Casting 


The FreeRTOS source code can be compiled with a lot of different compilers, all of which have 
different quirks as to how and when they generate warnings. In particular different compilers want 
casting to be used in different ways. As a result the FreeRTOS source code contains more type 
casting than would normally be warranted. 
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APPENDIX 6: LICENSING INFORMATION 


FreeRTOS is licensed under a modified version of the GNU General Public License (GPL) and can be 
used in commercial applications under that license. An alternative and optional commercial license is 
also available if: 


e You cannot fulfill the requirements stated in the "Open Source Modified GPL license" column 
of Table 25. 


e You wish to receive direct technical support. 
e You wish to have assistance with your development. 


e You require guarantees and indemnification. 


Table 25 Open Source Vs Commercial License Comparison 


Open source modified Commercial 
GPL license license 
Is it free? Yes No 
Can | use it in a commercial application? Yes Yes 
Is it royalty free? Yes Yes 
Do | have to open source my application code? No No 
Do | have to open source my changes to the FreeRTOS Yes No 
kernel? 
Do | have to document that my product uses Yes No 
FreeRTOS. 
Do | have to offer to provide the FreeRTOS source code Yes (a WEB link to the No 
to users of my application? FreeRTOS.org site is 
normally sufficient) 
Can | receive support on a commercial basis? No Yes 
Are any legal guarantees provided? No Yes 
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Open Source License Details 


The FreeRTOS source code is licensed under version 2 of the GNU General Public License (GPL) 
with an exception. The full text of the GPL is available at http://www.freertos.org/license.txt. The text 
of the exception is provided below. 


The exception permits the source code of applications that use FreeRTOS solely through the API 
published on the FreeRTOS.org WEB site to remain closed source, thus permitting the use of 
FreeRTOS in commercial applications without necessitating that the entire application be open 
sourced. The exception can only be used if you wish to combine FreeRTOS with a proprietary product 
and you comply with the terms stated in the exception itself. 


GPL Exception Text 


Note the exception text is subject to change. Consult the FreeRTOS.org WEB site for the most up to 
date version. 


Clause 1 


Linking FreeRTOS statically or dynamically with other modules is making a combined work based on FreeRTOS. Thus, the 
terms and conditions of the GNU General Public License cover the whole combination. 


As a special exception, the copyright holder of FreeRTOS gives you permission to link FreeRTOS with independent modules 
that communicate with FreeRTOS solely through the FreeRTOS API interface, regardless of the license terms of these 
independent modules, and to copy and distribute the resulting combined work under terms of your choice, provided that: 


1. Every copy of the combined work is accompanied by a written statement that details to the recipient the version of 
FreeRTOS used and an offer by yourself to provide the FreeRTOS source code should the recipient request it. 


2. The combined work is not itself an RTOS, scheduler, kernel or related product. 
3. The combined work is not itself a library intended for linking into other software applications. 
Any FreeRTOS source code, whether modified or in it's original release form, or whether in whole or in part, can only be 


distributed by you under the terms of the GNU General Public License plus this exception. An independent module is a 
module which is not derived from or based on FreeRTOS. 


Clause 2 


FreeRTOS.org may not be used for any competitive or comparative purpose, including the publication of any form of run time 
or compile time metric, without the express permission of Richard Barry (this is the norm within the industry and is intended 
to ensure information accuracy). 
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N starvation, 17 
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queue access by Multiple Tasks, 47 uxTaskPriorityGet(), 32 
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queue item size, 47 V 
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Queues, 45 vApplicationStackOverflowHook, 131 
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vSemaphoreCreateBinary(), 70, 83 

RAM allocation, 122 vTaskDelay(), 21 

Read, Modify, Write Operations, 97 vTaskDelayUntil(), 24 


vTaskDelete(), 38 
reentrant, 98 vTaskPrioritySet(), 32 


Removing Unused Files, 139 vTaskResume(), 19 


Run Time Stack Checking, 131 vTaskSuspend(), 19 
Running state, 5, 19 vTaskSuspendAll(), 103 
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spare processing capacity xQueueHandle, 49 
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Stack Overflow, 130 xQueueReceiveFromISR(), 87 
xQueueSend(), 50 
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soft real time, 2 
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